dark side / code

cd ../arsenal

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 ·

→ github → download v1.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