Get the FREE Ultimate OpenClaw Setup Guide →

mcp

mcp server

Installation
Run this command in your terminal to add the MCP server to Claude Code.
Run in terminal:
Command
claude mcp add --transport stdio pranavmanoj1-mcp-server node path/to/server.js \
  --env GOOGLE_CLIENT_ID="Your Google Cloud Console client ID" \
  --env GOOGLE_REDIRECT_URI="Your configured redirect URI" \
  --env GOOGLE_CLIENT_SECRET="Your Google Cloud Console client secret"

How to use

This MCP server integrates Google Calendar with the Model Context Protocol to enable context-aware calendar management. It supports listing upcoming events, creating new events with titles, locations, and attendees, updating existing events, and deleting events across multiple calendars. The server maintains context across operations and uses OAuth 2.0 for secure authentication, storing credentials and tokens securely. To use it, obtain Google OAuth credentials and configure the environment variables as described, then start the server and interact with it through natural language prompts. Typical workflows include asking to show upcoming events, scheduling new meetings with attendees, rescheduling, or updating event details, all while benefiting from context-aware formatting and validation provided by the MCP layer.

How to install

Prerequisites:

  • Node.js v16 or higher
  • npm (comes with Node.js)
  • Google Cloud Platform account and a project with Google Calendar API enabled
  • OAuth 2.0 credentials (client ID, client secret, and redirect URI) configured for your app

Installation steps:

  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 (optional if you prefer env vars in the config): cp .env.example .env

  4. Configure Google OAuth credentials in the environment:

    • In .env or your environment, set: GOOGLE_CLIENT_ID, GOOGLE_CLIENT_SECRET, GOOGLE_REDIRECT_URI
  5. Build the project (if applicable): npm run build

  6. Start the server: npm start

  7. Verify and authenticate:

    • Follow the OAuth flow as prompted to grant access to Google Calendar.
    • Ensure the tokens are stored securely by the MCP server.

Additional notes

Tips and common considerations:

  • Ensure the Google Calendar API is enabled in your Google Cloud project and that OAuth consent screen is configured.
  • Store Google OAuth tokens securely; the server should not commit credentials to version control.
  • If you rotate credentials, update the environment variables and redeploy.
  • The MCP server can handle multiple calendars; ensure the authenticated account has access to the calendars you intend to manage.
  • When testing, use a dedicated test calendar to avoid impacting production data.
  • Check logs for authentication errors or API quota issues; ensure you have appropriate OAuth scopes for read/write access to calendars.

Related MCP Servers

Sponsor this space

Reach thousands of developers