calendar-mcp

calendar-mcp

3.4

If you are the rightful owner of calendar-mcp and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

The Google Calendar MCP Server is a Python-based server that interfaces between LLMs and the Google Calendar API, enabling natural language calendar operations.

The Google Calendar MCP Server is designed to facilitate seamless interaction between Large Language Models (LLMs) and the Google Calendar API. By leveraging the Model Context Protocol (MCP), this server allows LLMs to perform various calendar operations through natural language requests. Built on FastAPI, it provides a RESTful API for core calendar actions such as listing, creating, updating, and deleting events, as well as advanced scheduling and analysis features. The server ensures secure access to the Google Calendar API using OAuth 2.0, with automatic token storage and refresh capabilities. Additionally, it integrates MCP-compatible tools via stdio using the `mcp_sdk` library, making it a versatile solution for developers looking to enhance LLM capabilities with calendar functionalities.

Features

  • Authentication: Secure Google Calendar API access using OAuth 2.0 with automatic token storage and refresh.
  • Core Calendar Actions: Includes listing, creating, updating, and deleting events, as well as adding attendees.
  • Advanced Scheduling & Analysis: Features like checking attendee status, querying free/busy information, and analyzing event busyness.
  • Server: FastAPI-based server exposing actions via a RESTful API.
  • MCP Integration: Provides MCP-compatible tools via stdio using the `mcp_sdk` library.

Tools

  1. mcp_google_calendar_list_calendars

    Lists all calendars available to the user.

  2. mcp_google_calendar_create_calendar

    Creates a new calendar.

  3. mcp_google_calendar_find_events

    Finds events with basic and advanced filtering.

  4. mcp_google_calendar_create_event

    Creates detailed events.

  5. mcp_google_calendar_quick_add_event

    Quickly adds events from text.

  6. mcp_google_calendar_update_event

    Updates existing events.

  7. mcp_google_calendar_delete_event

    Deletes events.

  8. mcp_google_calendar_add_attendee

    Adds attendees to events.

  9. mcp_google_calendar_check_attendee_status

    Checks the response status of attendees.

  10. mcp_google_calendar_query_free_busy

    Queries free/busy information for multiple calendars.

  11. mcp_google_calendar_schedule_mutual

    Finds mutual free slots and schedules meetings automatically.

  12. mcp_google_calendar_analyze_busyness

    Analyzes daily event counts and durations.