google-personal-mcp
Local MCP server for one personal Google account: Claude Code searches, labels and trashes Gmail and manages calendar events, via your own OAuth client.
Python · MIT · v1.0.0 · ★0 ·
what it does
- Finds old, bulky or low-value mail and labels or trashes it in batches of up to 1,000 messages.
- Reads calendars, events and free/busy time, and creates, edits or deletes events only on calendars the account owns.
- Cannot send or reply to mail, delete it for good or invite guests.
- Talks to Google through an OAuth client in your own Cloud project, so your data never passes through a third-party app.
- Every write returns what you need to undo it, and trashed mail stays recoverable for 30 days.
quick start
git clone https://github.com/slackwero/google-personal-mcp.git
cd google-personal-mcp
uv sync --locked
GOOGLE_PERSONAL_MCP_ACCOUNT=<your Gmail address> uv run --locked google-personal-mcp login
claude mcp add --scope local google-personal \
-e GOOGLE_PERSONAL_MCP_ACCOUNT=<your Gmail address> \
-- uv run --locked --directory <path to this repo> google-personal-mcp serve