Google Calendar MCP Server

by pranavmanoj1

Integrations

  • Uses .env files for secure configuration and storage of credentials needed for Google Calendar API access.

  • Enables intelligent, context-aware calendar management including listing upcoming events, creating new events with custom details, updating existing events, and deleting events across multiple calendars.

  • Utilizes Google Cloud Platform and OAuth 2.0 for secure authentication and token management when accessing Google Calendar data.

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.

-
security - not tested
F
license - not found
-
quality - not tested

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

A Model Context Protocol server that enables natural language interaction with Google Calendar, allowing users to view, create, update, and delete calendar events through context-aware operations.

  1. Features
    1. Prerequisites
      1. Setup
        1. Usage Examples
          1. Event Listing
          2. Event Creation
          3. Event Updates
          4. Event Deletion
        2. Security
          1. Contributing

            Related MCP Servers

            • -
              security
              A
              license
              -
              quality
              Enables comprehensive calendar management with capabilities to create, list, update, and delete events through a Model Context Protocol server integrated with Google Calendar.
              Last updated -
              13
              1
              TypeScript
              MIT License
            • -
              security
              F
              license
              -
              quality
              Allows interaction with Google Calendar through Claude Desktop using the Model Context Protocol, enabling calendar event management and schedule analysis.
              Last updated -
              2
              JavaScript
              • Apple
            • -
              security
              F
              license
              -
              quality
              Model Context Protocol server that provides seamless access to Google Calendar API with asynchronous operation support, enabling efficient calendar management through a standardized interface.
              Last updated -
              Python
              • Apple
              • Linux
            • -
              security
              A
              license
              -
              quality
              A Model Context Protocol server that integrates Google Calendar with Claude Desktop, enabling users to manage calendar events (view, create, update, delete) through natural language.
              Last updated -
              133
              21
              TypeScript
              MIT License

            View all related MCP servers

            ID: skol6yx2c2