google-calendar-mcp-server
If you are the rightful owner of google-calendar-mcp-server 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.
A Model Context Protocol (MCP) server that provides tools for interacting with Google Calendar API. This server enables you to manage your calendar events programmatically through the MCP interface.
Google Calendar MCP Server
A Model Context Protocol (MCP) server that provides tools for interacting with Google Calendar API. This server enables you to manage your calendar events programmatically through the MCP interface.
Features
Calendar Tools
list_events: List upcoming calendar events with date range filteringcreate_event: Create new calendar events with attendeesupdate_event: Update existing calendar eventsdelete_event: Delete calendar events
Prerequisites
- Node.js: Install Node.js version 14 or higher
- Google Cloud Console Setup:
- Go to Google Cloud Console
- Create a new project or select an existing one
- Enable the Google Calendar API:
- Go to "APIs & Services" > "Library"
- Search for and enable "Google Calendar API"
- Set up OAuth 2.0 credentials:
- Go to "APIs & Services" > "Credentials"
- Click "Create Credentials" > "OAuth client ID"
- Choose "Web application"
- Set "Authorized redirect URIs" to include:
http://localhost:3000/code - Note down the Client ID and Client Secret
Setup Instructions
-
Clone and Install:
git clone https://github.com/yourusername/google-calendar-mcp-server.git cd google-calendar-mcp-server npm install -
Create OAuth Credentials: Create a
credentials.jsonfile in the root directory:{ "web": { "client_id": "YOUR_CLIENT_ID", "client_secret": "YOUR_CLIENT_SECRET", "redirect_uris": ["http://localhost:3000/code"], "auth_uri": "https://accounts.google.com/o/oauth2/auth", "token_uri": "https://oauth2.googleapis.com/token" } } -
Get Refresh Token:
node get-refresh-token.jsThis will:
- Open your browser for Google OAuth authentication
- Request the following permissions:
https://www.googleapis.com/auth/calendar
- Save the credentials to
token.json - Display the refresh token in the console
-
Configure MCP Settings: Add the server configuration to your MCP settings file:
- For VSCode Claude extension:
~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json - For Claude desktop app:
~/Library/Application Support/Claude/claude_desktop_config.json
Add this to the
mcpServersobject:{ "mcpServers": { "google-calendar": { "command": "node", "args": ["/path/to/google-calendar-server/build/index.js"], "env": { "GOOGLE_ACCESS_TOKEN": "your_access_token", } } } } - For VSCode Claude extension:
-
Build and Run:
npm run build
Usage Examples
Calendar Operations
-
List Events:
{ "maxResults": 10, "timeMin": "2024-01-01T00:00:00Z", "timeMax": "2024-12-31T23:59:59Z" } -
Create Event:
{ "summary": "Team Meeting", "location": "Conference Room", "description": "Weekly sync-up", "start": "2024-01-24T10:00:00Z", "end": "2024-01-24T11:00:00Z", "attendees": ["colleague@example.com"] } -
Update Event:
{ "eventId": "event_id", "summary": "Updated Meeting", "location": "Virtual", "description": "Rescheduled weekly sync-up", "start": "2024-01-25T10:00:00Z", "end": "2024-01-25T11:00:00Z" } -
Delete Event:
{ "eventId": "event_id" }
License
MIT
