Personal Assistant

Natural-Language Google Calendar Agent (MCP)

Talk to your calendar in plain English: an MCP-connected agent that creates events, checks availability, manages invites, and imports events from images or PDFs, usable from Claude, Cursor, or any MCP host.

What It Does

This recipe gives an LLM agent full read/write access to your Google Calendar through a Model Context Protocol (MCP) server. You type things like “move my 3pm to tomorrow” or “find a free 30-minute slot Thursday afternoon and invite Sam” and the agent performs the CRUD operation directly. The open-source server (nspady/google-calendar-mcp) also supports natural-language understanding of dates/times and “intelligent import” — adding events parsed from images, PDFs, or web links.

The Stack

  • Google Calendar MCP server — the nspady/google-calendar-mcp server exposes calendar create / read / update / delete plus smart scheduling and import as MCP tools.
  • An MCP host — Claude Desktop, Cursor, or any MCP-capable client connects to the server; no custom UI needed.
  • An LLM — any MCP-capable model, e.g. via the Anthropic Startup Program credits or a free tool-calling model from GitHub Models.
  • Google OAuth — a Google Cloud project with the Calendar API enabled and OAuth credentials.

Step-by-Step Outline

  1. Enable the API — create a Google Cloud project, enable the Calendar API, and generate OAuth client credentials.
  2. Run the MCP server — install and start nspady/google-calendar-mcp, completing the OAuth consent flow so it can act on your calendar.
  3. Register the server in your MCP host’s config (Claude Desktop / Cursor) so its calendar tools appear to the agent.
  4. Drive it in natural language — create events, check availability, and manage invites by chatting; try the image/PDF import for pasting in event details.
  5. Add guardrails — keep destructive operations (delete, mass-invite) behind a confirmation step in your host.

Source

nspady/google-calendar-mcp — Google Calendar MCP Server (Awesome MCP Servers listing)