How do I install gmail-mcp-server?

Its README did not state an install command plainly enough for us to quote one, so we do not guess. The repository has the instructions: https://github.com/PaulFidika/gmail-mcp-server

What does gmail-mcp-server connect to, and what does it need?

It reaches gmail and openai. The credentials we found in its source are GMAIL_CLIENT_SECRET and OPENAI_API_KEY.

Which AI clients can use gmail-mcp-server?

Its own description mentions Claude Desktop and Cursor. That is a mention in its description, not a test we ran.

Is gmail-mcp-server official and is it maintained?

We found nothing naming it as a vendor’s official server. Its repository has 22 GitHub stars and its state in our directory is stale. Its last commit we recorded was on 2025-06-24.

What licence does gmail-mcp-server use?

The repository declares the MIT licence.

InfratoApp / Resources / MCP servers / gmail-mcp-server

gmail-mcp-server

gmail-mcp-server is an MCP server, listed under communication. It reaches gmail and openai. It needs GMAIL_CLIENT_SECRET and OPENAI_API_KEY to authenticate. Its repository has 22 GitHub stars and is licensed under MIT; we last read it on 2026-10-22.

This single-file MCP-server allows interaction with Gmail and is compatible with Claude Desktop and Cursor.

Install

MCP servers are packaged differently from each other -- some run via npx, some as a Docker image, some as a plain script you clone and run. gmail-mcp-server’s own README did not state one plainly enough for this page to quote it rather than guess, so it will not guess. The repository below states it.

Read gmail-mcp-server’s own install instructions ↗

What it reaches, and what it needs

Reaches

gmail, openai

Credential

GMAIL_CLIENT_SECRET, OPENAI_API_KEY

What it connects to

Supported in

Claude Desktop, Cursor

Unverified means a mention in the server’s own description, not a citation. A wrong claim here costs nothing to correct and nothing to trust yet.

Maintenance

Stars

State

stale

Licence

MIT

From the repository

A single-file MCP-server for interacting with Gmail. Works with Claude Desktop and Cursor.

View on GitHub ↗2026-10-22

What gmail-mcp-server can do

4 tools documented in its README. An AI client calls these by name.

search_threads: Search Gmail with queries like "from:email@example.com" or "subject:meeting" (includes draft info)
create_draft: Create email drafts or update existing drafts (AI will request style guide first)
extract_attachment_by_filename: Safely extract text from PDF, DOCX, and TXT attachments using filename
get_personal_email_style_guide: Get your email writing style guide (this is a temporary tool, created because most agents do not yet support fetching resources--once agents implement MCP resources better, then this tool can be remov

Read from the README; names are kept only if the README contains them.

gmail-mcp-server compared with similar servers

gmail-mcp-server compared with the closest alternatives, by services reached, credentials, stars, last update and licence
Server	Reaches	Needs	Stars	Last update	Licence
gmail-mcp-server (this page)	gmail, openai	GMAIL_CLIENT_SECRET, OPENAI_API_KEY	22	2025-06-24	MIT
google-workspace-mcp	gmail, google(1 shared)	GOOGLE_CLIENT_SECRET	192	2026-10-21	Apache-2.0
mail-mcp	gmail, mail(1 shared)	MAIL_OAUTH2_DEFAULT_CLIENT_SECRET, MAIL_OAUTH2_DEFAULT_REFRESH_TOKEN, MAIL_OAUTH2_WORK_CLIENT_SECRET, MAIL_OAUTH2_WORK_REFRESH_TOKEN	108	2026-10-23	MIT
mcp-server-email	gmail(1 shared)	None listed	81	2025-04-27	MIT
mcp-headless-gmail	gmail(1 shared)	None listed	55	2025-05-24	MIT
mail-use	gmail(1 shared)	None listed	47	2026-10-13	MIT

Ranked by services in common with gmail-mcp-server, then by stars. Figures are from each repository when we last read it.

Common questions about gmail-mcp-server

What does gmail-mcp-server do?: This single-file MCP-server allows interaction with Gmail and is compatible with Claude Desktop and Cursor.
How do I install gmail-mcp-server?: Its README did not state an install command plainly enough for us to quote one, so we do not guess. The repository has the instructions: https://github.com/PaulFidika/gmail-mcp-server
What does gmail-mcp-server connect to, and what does it need?: It reaches gmail and openai. The credentials we found in its source are GMAIL_CLIENT_SECRET and OPENAI_API_KEY.
Which AI clients can use gmail-mcp-server?: Its own description mentions Claude Desktop and Cursor. That is a mention in its description, not a test we ran.
Is gmail-mcp-server official and is it maintained?: We found nothing naming it as a vendor’s official server. Its repository has 22 GitHub stars and its state in our directory is stale. Its last commit we recorded was on 2025-06-24.
What licence does gmail-mcp-server use?: The repository declares the MIT licence.

More MCP servers for communication

All communication entries →