Calendar MCP Server
About
Calendar MCP Server is a Model Context Protocol (MCP) server that integrates Google Calendar with Claude Desktop. It enables AI assistants to manage Google Calendar events through natural language interactions, handling event creation, retrieval, updating, deletion, and listing…
Details
- Author
- MCP-Mirror
- Downloads
- 366
- Categories
- Productivity
Jump to
- Create calendar events with title, time, description, and location
- Retrieve event details by event ID
- Update existing events (title, time, description, location)
- Delete events
- List events within a specified time range
- Full integration with Google Calendar API via secure OAuth2 authentication
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Calendar MCP ServerCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Install via Smithery (npx -y @smithery/cli install @gongrzhe/server-calendar-mcp --client claude) or npm (npm install @gongrzhe/server-calendar-mcp). Set up a Google Cloud Project with OAuth 2.0 credentials and a refresh token. Configure the server in Claude Desktop using environment variables GOOGLE_CLIENT_ID, GOOGLE_CLIENT_SECRET, and GOOGLE_REFRESH_TOKEN.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"calendar mcp server": {
"GongRzhe_Calendar-MCP-Server": {
"command": "npx",
"args": [
"-y",
"@smithery/cli",
"install",
"@gongrzhe/server-calendar-mcp",
"--client",
"claude"
]
}
}
}
}McpServers
{
"GongRzhe_Calendar-MCP-Server": {
"command": "npx",
"args": [
"-y",
"@smithery/cli",
"install",
"@gongrzhe/server-calendar-mcp",
"--client",
"claude"
]
}
}Calendar MCP Server
A Model Context Protocol (MCP) server for Google Calendar integration in Claude Desktop. This server enables AI assistants to manage Google Calendar events through natural language interactions.
Features
- Create calendar events with title, time, description, and location
- Retrieve event details by event ID
- Update existing events (title, time, description, location)
- Delete events
- List events within a specified time range
- Full integration with Google Calendar API
- Secure OAuth2 authentication
Installation
Installing via Smithery
To install Google Calendar Integration for Claude Desktop automatically via Smithery:
npx -y @smithery/cli install @gongrzhe/server-calendar-mcp --client claude
Manual Installation
npm install @gongrzhe/server-calendar-mcp
Setup
1. Create a Google Cloud Project and obtain credentials:
a. Create a Google Cloud Project:
- Go to Google Cloud Console
- Create a new project or select an existing one
- Enable the Google Calendar API for your project
b. Create OAuth 2.0 Credentials:
- Go to "APIs & Services" > "Credentials"
- Click "Create Credentials" > "OAuth client ID"
- Choose "Desktop app" as application type
- Give it a name and click "Create"
- You will get your GOOGLE_CLIENT_ID and GOOGLE_CLIENT_SECRET
c. Get Refresh Token:
- Go to OAuth 2.0 Playground
- Click the gear icon (Settings) in the top right
- Check "Use your own OAuth credentials"
- Enter your OAuth Client ID and Client Secret
- In the left panel, find "Calendar API v3" and select "https://www.googleapis.com/auth/calendar"
- Click "Authorize APIs" and complete the OAuth flow
- Click "Exchange authorization code for tokens"
- Copy the "Refresh token" - this is your GOOGLE_REFRESH_TOKEN
2. Configure in Claude Desktop:
{
"calendar": {
"command": "npx",
"args": [
"@gongrzhe/server-calendar-mcp"
],
"env": {
"GOOGLE_CLIENT_ID": "your_client_id_here",
"GOOGLE_CLIENT_SECRET": "your_client_secret_here",
"GOOGLE_REFRESH_TOKEN": "your_refresh_token_here"
}
}
}
Usage Examples
The server provides several tools that can be used through the Claude Desktop:
Create Event
{
"summary": "Team Meeting",
"start": {
"dateTime": "2024-01-20T10:00:00Z"
},
"end": {
"dateTime": "2024-01-20T11:00:00Z"
},
"description": "Weekly team sync",
"location": "Conference Room A"
}
List Events
{
"timeMin": "2024-01-01T00:00:00Z",
"timeMax": "2024-12-31T23:59:59Z",
"maxResults": 10,
"orderBy": "startTime"
}
Update Event
{
"eventId": "event123",
"summary": "Updated Meeting Title",
"start": {
"dateTime": "2024-01-20T11:00:00Z"
},
"end": {
"dateTime": "2024-01-20T12:00:00Z"
}
}
Delete Event
{
"eventId": "event123"
}
Security Notes
- Keep your Google API credentials secure
- Regularly rotate your refresh tokens
- Store sensitive information in Claude Desktop configuration
- Never share or commit your credentials to version control
- The refresh token gives access to your Google Calendar, treat it like a password
Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
License
This project is licensed under the ISC License.
Author
gongrzhe
Support
If you encounter any issues or have questions, please file an issue on the GitHub repository.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
