# Google Calendar Mcp

> Multi-account Google Calendar MCP server for Claude — list, read, create, update, delete, and analyze events across multiple Google accounts

- **Type:** MCP server
- **Install:** `agentstack add mcp-chienchuanw-google-calendar-mcp`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [chienchuanw](https://agentstack.voostack.com/s/chienchuanw)
- **Installs:** 0
- **Category:** [AI & ML](https://agentstack.voostack.com/c/ai-and-ml)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [chienchuanw](https://github.com/chienchuanw)
- **Source:** https://github.com/chienchuanw/google-calendar-mcp

## Install

```sh
agentstack add mcp-chienchuanw-google-calendar-mcp
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# google-calendar-mcp

Multi-account Google Calendar MCP server — list, read, create, update, delete, and analyze events across several Google accounts from Claude. Every tool takes an `account` alias; event tools take an optional `calendarId` (defaults to the account's primary calendar).

## Setup

1. **Create a Google OAuth client**: Google Cloud Console → new project → enable the **Google Calendar API** → configure the **OAuth consent screen** (External) and add scopes:
   ```
   https://www.googleapis.com/auth/calendar
   https://www.googleapis.com/auth/calendar.events
   ```
   Add your Google address(es) under **Test users**. Then **Credentials → Create credentials → OAuth client ID → Desktop app → Download JSON**.

2. **Install and place credentials:**
   ```bash
   npm install && npm run build
   mkdir -p ~/.gcal-mcp
   cp /path/to/downloaded-credentials.json ~/.gcal-mcp/credentials.json
   ```

3. **Add one or more accounts** (opens a browser each time; port 3000 must be free):
   ```bash
   node dist/index.js auth add work
   node dist/index.js auth add personal
   node dist/index.js auth list
   ```

4. **Register with Claude Code:**
   ```bash
   claude mcp add gcal -- node /absolute/path/to/google-calendar-mcp/dist/index.js
   ```

## Tools

`calendar_list_accounts`, `calendar_list_calendars`, `calendar_list_events`, `calendar_get_event`, `calendar_freebusy`, `calendar_create_event`, `calendar_update_event`, `calendar_delete_event`.

Writes never notify attendees unless you pass `sendUpdates: "all"` (default `"none"`). `calendar_delete_event` refuses events with attendees unless `confirm: true`, and returns the deleted event body.

## Storage

```
~/.gcal-mcp/
├── credentials.json      # shared Google OAuth client (never commit)
└── accounts/
    ├── work.json         # { alias, email, token }  (never commit)
    └── personal.json
```

Override the directory with `GCAL_MCP_CONFIG_DIR`. Tokens auto-refresh; if refresh fails, re-run `gcal-mcp auth add  --force`.

## Development

```bash
npm test           # vitest
npm run build      # tsc -> dist/
npm run typecheck  # tsc --noEmit
```

## Packaging (MCPB)

`bash scripts/build-mcpb.sh` produces `build/google-calendar-mcp.mcpb`. OAuth setup (`credentials.json` + `gcal-mcp auth add `) must still be done from a terminal.

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [chienchuanw](https://github.com/chienchuanw)
- **Source:** [chienchuanw/google-calendar-mcp](https://github.com/chienchuanw/google-calendar-mcp)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-chienchuanw-google-calendar-mcp
- Seller: https://agentstack.voostack.com/s/chienchuanw
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.