calendar-mcp

local MCP server

Installation

Terminal

claude mcp add io-github-deciduus-calendar-mcp -e GOOGLE_CLIENT_ID=... -e GOOGLE_CLIENT_SECRET=... -e TOKEN_FILE_PATH=... -- uvx calendar-mcp-server

Run in your project folder. Add --scope user to use it everywhere.

Claude Desktop, Cursor & other clients

Add to claude_desktop_config.json or .cursor/mcp.json.

{
  "mcpServers": {
    "io-github-deciduus-calendar-mcp": {
      "command": "uvx",
      "args": [
        "calendar-mcp-server"
      ],
      "env": {
        "GOOGLE_CLIENT_ID": "...",
        "GOOGLE_CLIENT_SECRET": "...",
        "TOKEN_FILE_PATH": "..."
      }
    }
  }
}

Fill in the environment variables with your own credentials.

Summary

Google Calendar for LLM agents: find, create, update, move, delete events; free/busy; scheduling.

Questions

calendar-mcp is a local MCP server distributed as the pypi package calendar-mcp-server.

Run: claude mcp add io-github-deciduus-calendar-mcp -e GOOGLE_CLIENT_ID=... -e GOOGLE_CLIENT_SECRET=... -e TOKEN_FILE_PATH=... -- uvx calendar-mcp-server

Run: codex mcp add io-github-deciduus-calendar-mcp --env GOOGLE_CLIENT_ID=... --env GOOGLE_CLIENT_SECRET=... --env TOKEN_FILE_PATH=... -- uvx calendar-mcp-server

Similar MCP servers

NameStars

caldav-mcpio.github.dominik1001/caldav-mcp102
Apple Calendario.github.JonathanRReed/apple-calendar-mcp18
Agent-Native Calendario.github.BuilderIO/agent-native-calendar6,874
three.ws Alertsio.github.nirholas/alerts-mcp218
airtablecom.mcparmory/airtable31
Apple Remindersio.github.JonathanRReed/apple-mcp-reminders18
Microsoft 365 Calendario.github.mindstone/mcp-server-microsoft-calendar12
gtasks-mcpio.github.alvinjchoi/gtasks-mcp10