Which integrations are available for this server?

Allows searching, reading, archiving, trashing, marking read/unread, and managing labels for Gmail messages and threads.

How do I use gmail-mcp?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@gmail-mcp search my recent unread emails" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

gmail-mcp

by d-mato

Overview Schema Related Servers Score Discussions

TypeScript

Local

gmail-mcp

npm version

MCP server for Gmail — search, read, archive, and manage your email from any MCP client.

Setup

Add to your MCP client configuration:

{
  "mcpServers": {
    "gmail": {
      "command": "npx",
      "args": ["-y", "@d-mato/gmail-mcp"]
    }
  }
}

On first launch, a browser window will open for Google account authorization. After granting access, the token is stored locally at ~/.gmail-mcp/tokens.json and you won't need to authorize again.

Related MCP server: Gmail Plugin MCP Server

Available Tools

Messages

Tool	Description
`gmail_search`	Search messages using Gmail query syntax (e.g. `from:user@example.com`, `is:unread`)
`gmail_get_message`	Get the full content of a message by ID
`gmail_get_thread`	Get all messages in a thread by thread ID
`gmail_archive`	Archive a message (remove from inbox)
`gmail_batch_archive`	Archive multiple messages
`gmail_trash`	Move a message to trash
`gmail_batch_trash`	Move multiple messages to trash
`gmail_untrash`	Remove a message from trash
`gmail_mark_read`	Mark a message as read
`gmail_mark_unread`	Mark a message as unread

Labels

Tool	Description
`gmail_list_labels`	List all labels
`gmail_add_label`	Add a label to a message
`gmail_remove_label`	Remove a label from a message
`gmail_create_label`	Create a new label
`gmail_delete_label`	Delete a label

License

MIT

This server cannot be installed

license - permissive license

quality - not tested

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

2wRelease cycle

8Releases (12mo)

Commit activity

Resources

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly
Lightport: Open-Sourcing Glama's AI Gateway
By punkpeye on April 27, 2026.
OpenAI
open source

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/d-mato/gmail-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server