mcp-server

mcp-server

3.5
calendar_management

The Google Calendar MCP Server is designed to enhance calendar management through intelligent and context-aware operations. It allows users to perform various calendar functions such as listing, creating, updating, and deleting events using natural language commands. The project supports secure authentication via OAuth 2.0 and is built to handle robust error management.

Top Comments

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.