calendar-mcp

calendar-mcp

2
calendar_management

The Google Calendar MCP Server is a Python-based integration that allows large language models to interact with Google Calendar through natural language. It supports secure API access, a range of calendar operations, and offers a FastAPI server and MCP integration.

Google Calendar MCP Server (Python)

This project offers a Python-based MCP server that integrates with the Google Calendar API, enabling natural language calendar operations via LLMs.

Features

  • Secure access with OAuth 2.0.
  • Core calendar actions: list, create, find, update, delete events.
  • Advanced scheduling and analysis tools.
  • FastAPI-based server offering a RESTful API.
  • MCP-compatible tools using mcp_sdk.

Setup

  • Prerequisites: Python 3.8+, Git, Google Cloud Platform access.
  • Clone repository and configure OAuth credentials.
  • Set up environment configuration in .env file.
  • Install dependencies.

Running the Server

  • Complete initial authentication with Google OAuth.
  • Use FastAPI server for direct testing.

MCP Client Configuration

  • Configure client to run run_server.py script for MCP integration.

Development

  • Code structure and logging features.
  • Planned enhancements and testing.