Google Calendar MCP Server logo

Google Calendar MCP Server

by 101ta28

This server allows you to search Google Calendar contents as an MCP server, enabling integration with tools like GitHub Copilot Chat. It requires setting up a Google Cloud Project and configuring OAuth 2.0 credentials.

View on GitHub

Last updated: N/A

What is Google Calendar MCP Server?

The Google Calendar MCP Server is a Python-based server that allows you to access and search your Google Calendar events through the MCP (Message Passing Concurrency) protocol. This enables integration with tools like GitHub Copilot Chat, allowing you to query your calendar using natural language.

How to use Google Calendar MCP Server?

To use the server, you need to create a Google Cloud Project, enable the Google Calendar API, set up OAuth 2.0 credentials, configure the Python environment with uv, generate a token.json file for authentication, configure calendar_settings.json with your calendar IDs, configure the mcp.json file with the server details, enable Agent Mode in GitHub Copilot Chat, and then use natural language queries in the Copilot Chat panel.

Key features of Google Calendar MCP Server

  • Integration with GitHub Copilot Chat

  • Search Google Calendar events

  • Uses MCP protocol

  • Configurable calendar IDs

  • OAuth 2.0 authentication

Use cases of Google Calendar MCP Server

  • Querying calendar events using natural language in GitHub Copilot Chat

  • Automating calendar-related tasks

  • Integrating Google Calendar data into other applications

  • Quickly accessing upcoming events

  • Finding specific events based on keywords

FAQ from Google Calendar MCP Server

What is MCP?

MCP stands for Message Passing Concurrency. It's a protocol that allows different processes or services to communicate with each other by sending messages.

Why do I need to create a Google Cloud Project?

Creating a Google Cloud Project is necessary to enable the Google Calendar API and obtain the credentials required to access your Google Calendar data.

What is the purpose of the token.json file?

The token.json file stores the authentication token obtained after granting permission to access your Google account. This token is used to authenticate subsequent requests to the Google Calendar API.

How do I find my calendar ID?

Your primary calendar ID is usually 'primary'. For other calendars, you can find the ID in the calendar settings within the Google Calendar web interface.

What should I do if I encounter an error?

Check the error message for clues. You may need to reinstall dependencies, verify your settings in the Google Cloud Console, or ensure that you have granted the necessary permissions to access your Google account.