Which integrations are available for this server?

Provides read-only access to a Gmail inbox, allowing search using Gmail search syntax and retrieval of full email messages.

How do I use gmail-mcp?

This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.

gmail-mcp

A read-only Gmail MCP server, built from scratch on the MCP SDK — no third-party Gmail MCP packages. Lets Claude Code (or any MCP client) search and read a Gmail inbox without ever being able to send, delete, or modify anything.

Tools

Tool	What it does
`list_emails`	Search the inbox with full Gmail search syntax (`from:`, `newer_than:`, `has:attachment`, …), with a `maxResults` cap
`get_email`	Fetch a single message by id: headers plus the full plain-text body

Related MCP server: Gmail MCP Server

Design notes

Read-only by construction. The OAuth scope is gmail.readonly — the token Google issues cannot send or delete mail even if the server were compromised.
Google OAuth 2.0 Desktop-app flow. A one-time npm run auth opens a browser for consent, then stores a refresh token locally. The server auto-refreshes access tokens and persists them back to disk, so auth survives restarts.
Secrets stay out of the repo. credentials.json (OAuth client) and token.json (tokens) are gitignored; the code loads them from disk at startup.

Setup

In Google Cloud Console, create a project, enable the Gmail API, and create an OAuth client of type Desktop app. Download it as credentials.json into this folder. While the consent screen is in Testing mode, add your address under Audience → Test users.

Install and authenticate:

npm install
npm run auth   # opens browser, writes token.json

Register with Claude Code (user scope makes it available in every session):
```
claude mcp add gmail -s user -- node /absolute/path/to/gmail-mcp/index.js
```
Verify with claude mcp list — the server should show as Connected.

Files

index.js — the MCP server (tool definitions, Gmail API calls, token refresh persistence)
auth.js — one-time OAuth consent flow; writes token.json

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityInactive

ResponsivenessNo issues

Resources

Related MCP Connectors

gmail A
com.mintmcp
A MCP server for Gmail that lets you search, read, and draft emails and replies.
Communication App Automation Workplace & Productivity
1248
https://gmail.mintmcp.com/mcp
mcp4mail A
online.mcp4mail
Your IMAP mailbox as an MCP server: read, search and (if you allow it) organize mail. Open source.
Email Communication
141
https://mcp4mail.online/mcp
email A
dev.primitive
Email infrastructure for AI agents — send, receive, search, and reply to email over MCP.
Email Communication
142
https://www.primitive.dev/mcp
Conduit Mail
app.conduitmail
Your mailbox for MCP clients: search, read, draft, send, rules and notes. Sending is off by default.
Email Communication
1
https://connect.conduitmail.app/mcp

Related MCP Servers

Gmail MCP
Communication Search
annyzhou
A
license
Not graded
quality
D
maintenance
A read-only MCP server that enables users to interact with the Gmail API to search messages, retrieve threads, and download attachments. It supports standard Gmail query operators and requires OAuth authentication for secure read-only access to mailbox data.
Updated 9 months ago (2026-01-21 23:46 UTC)
1
MIT
Gmail MCP Server
Email Search
jlg-formation
A
license
Not graded
quality
D
maintenance
Read-only MCP server for Gmail that enables searching threads, reading messages, and listing labels without any write access.
Updated 4 months ago (2026-06-21 11:05 UTC)
208 npm
MIT
gmail-mcp
Email Communication
d-mato
A
license
Not graded
quality
B
maintenance
MCP server for Gmail that enables searching, reading, archiving, and managing email from any MCP client.
Updated 3 months ago (2026-08-14 15:20 UTC)
46 npm
1
MIT
gmail-mcp
Email Search
cunicopia-dev
A
license
A
quality
B
maintenance
An MCP server that reads across all your Gmail accounts from one connection, enabling searching, drafting, labeling, and filtering emails without sending.
Updated 2 months ago (2026-08-28 02:04 UTC)
17
72 PyPI
6
MIT