Google Calendar MCP Server

A powerful Model Context Protocol (MCP) server that integrates with Google Calendar to provide intelligent, context-aware calendar management capabilities.

Features

- Smart Calendar Management
- List and view upcoming events with detailed information
- Create new events with custom titles, locations, and attendees
- Update existing events with new information
- Delete events from your calendar
- Support for multiple calendars

- Context-Aware Operations
- Maintains context between calendar operations
- Intelligent event formatting and display
- Secure authentication and token management
- Robust error handling and validation

Prerequisites

- Node.js (v16 or higher)
- Google Cloud Platform account
- Google Calendar API enabled
- OAuth 2.0 credentials from Google Cloud Console

Setup

1. Clone the repository:

   git clone https://github.com/yourusername/google-calendar-mcp.git

   cd google-calendar-mcp

   

2. Install dependencies:

   npm install

   

3. Create a .env file:

   cp .env.example .env

   

4. Update the .env file with your Google Calendar API credentials:
- GOOGLE_CLIENT_ID: Your Google Cloud Console client ID
- GOOGLE_CLIENT_SECRET: Your Google Cloud Console client secret
- GOOGLE_REDIRECT_URI: Your configured redirect URI

5. Build the project:

   npm run build

   

6. Start the server:

   npm start

   

Usage Examples

The MCP server supports various calendar operations through natural language commands:

Event Listing

- "Show me my next 5 upcoming events" - "List all events for next week" - "What's on my calendar for tomorrow?"

Event Creation

- "Schedule a meeting with John and Sarah tomorrow at 2pm" - "Create a lunch event with the team next Friday at 12pm" - "Add a doctor's appointment for next Monday at 10am"

Event Updates

- "Move my 2pm meeting to 3pm" - "Add Mike to tomorrow's team meeting" - "Update the location of Friday's meeting"

Event Deletion

- "Cancel my 3pm meeting today" - "Remove the team lunch from next Friday"

Security

- All credentials and tokens are stored securely and are not committed to version control
- OAuth 2.0 authentication ensures secure access to Google Calendar
- Environment variables are used for sensitive configuration

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.