概览
What is MCP Google Calendar Server?
An MCP (Model Context Protocol) server that integrates Google Calendar with MCP clients like Claude Desktop. It enables adding and querying Google Calendar events through natural language interactions. Built with TypeScript and Node.js.
How to use MCP Google Calendar Server?
Install dependencies, configure GOOGLE_CLIENT_ID and GOOGLE_CLIENT_SECRET in a .env file, and set up the server in claude_desktop_config.json. Build with npm run build, then invoke tools such as addCalendarEvent or listCalendarEvents through Claude Desktop.
Key features of MCP Google Calendar Server
- Google OAuth 2.0 authentication
- Add events to Google Calendar
- List calendar events by date range
- Get today's date in YYYY-MM-DD format
- Korean timezone (KST) support
- Detailed error handling and Pino logging
Use cases of MCP Google Calendar Server
- Scheduling meetings or reminders via Claude Desktop
- Checking upcoming events for a specific date range
- Integrating Google Calendar into AI assistant workflows
- Automating event creation from natural language commands
FAQ from MCP Google Calendar Server
What tools does MCP Google Calendar Server provide?
It provides googleAuthLogin for OAuth authentication, addCalendarEvent to create events, listCalendarEvents to query events by period, and getTodayDate to return the current date.
What are the runtime requirements?
The server requires Node.js and a Google Cloud project with the Calendar API enabled and a desktop app OAuth 2.0 client ID/secret.
How do I handle connection or authentication issues?
Check Claude Desktop logs, verify the server process is running, confirm environment variables are set, and ensure the OAuth consent screen and API activation are correct.
Can this server be used without Claude Desktop?
It is designed for MCP clients and the setup instructions specifically target Claude Desktop. No other clients are mentioned.
What data does the server access?
It accesses the authenticated Google Calendar account via the Calendar API. No data storage is described beyond logs from the Pino logger.
