MCP Calendar Server

A local Model Context Protocol (MCP) server that connects Claude Desktop to your Google Calendar.

This lets Claude manage calendar events, check schedules, and even calculate travel time between meetings all locally.

---

Features

• Manage Events — Add, update, delete, or view Google Calendar events
• Get Event Details — Fetch details for specific events
• Get Coordinates — Retrieve coordinates for a given place using OpenRouteService
• Travel Estimates — Calculate distance and time between two points
• Runs Locally — No data leaves your computer

---

How It Works

Claude Desktop supports MCP (Model Context Protocol) to interact with local or remote tools.
This project implements an MCP server in Node.js that communicates with Claude over stdio.

---

Tools Implemented

Tool	Description
get_events	List Google Calendar events within a date range
get_event	Fetch details of a specific event
add_event	Add a new event
update_event	Update an existing event
delete_event	Delete an event
get_coordinates	Get coordinates of a place
get_distance_and_time	Get distance and travel time between two coordinates

---

Setup

1. Clone the repository

git clone https://github.com/username/mcp-calendar.git
cd mcp-calendar

2. Install dependencies

npm install

3. Create a .env file

GOOGLE_CLIENT_ID=your_google_client_id
GOOGLE_CLIENT_SECRET=your_google_client_secret
GOOGLE_REDIRECT_URI=your_google_redirect_uri
GOOGLE_REFRESH_TOKEN=your_google_refresh_token
OPENROUTESERVICE_API_KEY=your_openrouteservice_api_key

4. Run the MCP server

npm run build
npm start

5. Connecting to Claude Desktop

Open Claude Desktop Go to Settings → Developer → Local MCP servers Add a new local server configuration like:

{
  "command": "node",
  "args": ["C:\\path\\to\\build\\index.js"],
  "env": {}
}

Restart Claude, it should automatically detect and connect to your MCP server.

Tech Stack

Node.js + TypeScript Google Calendar API OpenRouteService API Claude MCP SDK