Skip to content
Kitbay
MCP server

gmail-mcp-server

Runs locallyGPL-3.0Updated on Feb 1, 202573GitHub starsCan change dataNeeds an API key

A small Python MCP server that runs locally and connects an AI client to one Gmail account.

What it does

A small Python MCP server that runs locally and connects an AI client to one Gmail account. Its tools fetch unread mail, read a message (which also marks it read), mark mail as read, move a message to the trash, send a new email and open a message in the default browser. Setup needs a Google Cloud project with the Gmail API, an OAuth desktop client and a test user; on first start a browser sign-in runs and the token is stored at a path given on the command line. The README shows a Claude Desktop setup using uv and notes that the client asks the user before acting.

Capabilities

  • Get unread emails
  • Read an email's content
  • Send an email
  • Move an email to trash
  • Mark an email as read