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.