home / mcp / google calendar meeting mcp server

Google Calendar Meeting MCP Server

MCP Server to automate google meeting invite

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "arjuntheprogrammer-google_calendar_meeting_setup": {
      "command": "python",
      "args": [
        "mcp_server.py"
      ]
    }
  }
}

You can automate Google Calendar meeting invites via a dedicated MCP server. This server accepts a Meeting Calendar request from MCP clients and creates events on your Google Calendar using the Google Calendar API, enabling you to trigger invites with minimal input and consistent formatting.

How to use

To use this MCP server, connect with an MCP client and call the create_meeting_invite tool using the same argument names you would pass to the CLI. The server runs locally and communicates over stdio, so your client can start it and exchange commands through that channel. You can automate event creation by supplying the meeting time, participant email, title, notes, and optional host or duration.

How to install

Prerequisites and setup steps let you run the script and the MCP server locally.

conda create -n meeting_setup python=3.11
conda activate meeting_setup
pip install google-api-python-client google-auth-httplib2 google-auth-oauthlib mcp

MCP Server

The server runs over stdio transport. Start the MCP server and keep it ready to receive commands from your MCP client.

python mcp_server.py

Usage via MCP client

Once the MCP server is running, you can invoke the create_meeting_invite tool with the same argument names used by the CLI flags. This will return event details such as the summary, start and end times, and the Google Calendar link.

Example CLI flow (reference for MCP usage)

# Example usage through an MCP client (arguments align with CLI options)
# meeting_time, other_email, meeting_title, meeting_notes, duration_minutes, host_email
# This is represented to the MCP client; the server handles the actual API call.

Notes on credentials and setup

The setup requires a Google Cloud project with the Calendar API enabled and OAuth credentials saved in a file named credentials.json next to the server script.

Security and credentials

Protect the credentials.json file and restrict access to only trusted environments. The initial authorization creates a token.json file on first run, which is reused for subsequent runs.

Troubleshooting

If you encounter authentication errors, verify that credentials.json is correctly placed and that you have granted consent for the required Google accounts during the first run. Ensure the Calendar API is enabled in your Google Cloud project.

Notes

This MCP server is designed to work with MCP clients that can send the create_meeting_invite request through the stdio channel. Adjust your client configuration if you integrate with different MCP tooling.

Available tools

create_meeting_invite

Invokes the Google Calendar event creation flow. Accepts meeting_time, other_email, meeting_title, meeting_notes, duration_minutes, and host_email to generate a calendar invite and return event details such as summary, start, end, and htmlLink.