Google Calendar

Exposes Google Calendar data via MCP for get_todays_agenda and get_agenda_for_date

go

2

GitHub Stars

go

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "jeanlaurent-agenda-mcp": {
      "command": "/path/to/your/agenda-mcp",
      "args": [
        "mcp"
      ],
      "env": {
        "client_id": "your-google-oauth-client-id",
        "project_id": "your-google-project-id",
        "client_secret": "your-google-oauth-client-secret"
      }
    }
  }
}

You can run a lightweight MCP server that exposes your Google Calendar agenda to LLM-based tools. It fetches today’s or a specific date’s events and serves them through a Model Context Protocol endpoint, enabling seamless calendar-aware interactions with your applications while keeping credentials local to you.

How to use

Use the MCP server to access your Google Calendar data from client applications. You can fetch today’s agenda or specify a date, and you can run the server as an MCP endpoint so advanced systems can request calendar data on demand.

How to install

Prerequisites include a Go runtime and a task automation tool. You will also enable Google Calendar API access for your project.

# Prerequisites (Go environment helper installed will be shown in steps below)
# Ensure you have Go installed
# You will also need a task runner as described in the setup steps

Configuration and security

Follow these steps to configure access to Google Calendar and the MCP server.

# 1) Enable Google Calendar API for your project
# 2) Create OAuth credentials for a Desktop application and download credentials.json
# 3) Put credentials.json in the project directory
# 4) On first run, authorize access; the server saves credentials for future runs

MCP integration details

You can expose the calendar data as an MCP server so clients can request your agenda. The following configuration demonstrates a local MCP server entry built from the provided example.

{
  "mcpServers": {
    "google_calendar": {
      "command": "/path/to/your/agenda-mcp",
      "args": ["mcp"],
      "env": {
        "client_id": "your-google-oauth-client-id",
        "project_id": "your-google-project-id",
        "client_secret": "your-google-oauth-client-secret"
      }
    }
  }
}

Usage patterns

Start the MCP server to expose calendar data to compatible clients. - From a client, request today’s agenda or a specific date using the two MCP tools described below.

Available MCP tools

The MCP server provides two calendar-related tools for client applications.

get_todays_agenda  # Returns today’s calendar events
get_agenda_for_date  # Returns calendar events for a given date (YYYY-MM-DD)

Available tools

get_todays_agenda

Fetches today’s calendar events from Google Calendar and formats them for display or MCP consumption.

get_agenda_for_date

Fetches events for a specific date in YYYY-MM-DD format and returns a structured agenda.

inspector

MCP inspector tool to debug and test MCP server endpoints at http://localhost:8080.