gmail-mcp-imap
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| GMAIL_EMAIL | Yes | Your Gmail email address | |
| GMAIL_APP_PASSWORD | Yes | Your 16-character Gmail App Password |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| get_primary_emailsA | Get emails from Primary category - important conversations from real people |
| get_social_emailsA | Get emails from Social category - notifications from social networks like Facebook, Twitter, LinkedIn |
| get_promotions_emailsA | Get emails from Promotions category - marketing emails, deals, offers, newsletters |
| get_updates_emailsA | Get emails from Updates category - transactional emails like receipts, bills, statements, order confirmations |
| get_forums_emailsA | Get emails from Forums category - mailing lists, discussion groups, online forums |
| search_emailsA | Search emails using keywords - searches in subject and sender |
| get_email_contentA | Get full content of a specific email by its UID |
| get_emails_by_labelA | Get emails from a specific label or folder (e.g., Github, Naukri jobs, Notes, [Gmail]/Sent Mail, [Gmail]/All Mail). Supports after/before date filters for paging. Results include a |
| list_labelsA | List all Gmail labels and folders |
| send_emailB | Send a new email with optional attachments |
| reply_to_emailC | Reply to an existing email |
| mark_as_readB | Mark an email as read |
| mark_as_unreadB | Mark an email as unread |
| star_emailB | Star or unstar an email |
| delete_emailA | Move an email to trash |
| apply_labelB | Apply a label to an email |
| download_attachmentA | Download an email attachment and return it as Base64 encoded data. Use this to save attachments locally. |
| list_attachmentsA | List all attachments in an email (without downloading content) |
| save_attachmentC | Download an email attachment and save it to a specified file path |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 19 tools
Most tools target a distinct resource and action, but the five get_*_emails category tools are very similar in shape and could be mistaken for one another without reading the category name closely. download_attachment and save_attachment also overlap as two ways to fetch the same attachment.
The dominant verb_noun pattern is clear and consistent, but there are minor deviations: get_emails_by_label uses a prepositional structure, get_email_content is singular while other retrievers are plural, and mark_as_read/mark_as_unread differ slightly from the simpler verb_noun style used elsewhere.
19 tools is on the heavy side for an MCP server and includes reducible duplication: five category getters could be one parameterized tool, and download_attachment/save_attachment serve nearly the same need with different output handling. The remaining tools are relevant, but the set feels padded.
The core Gmail lifecycle is covered: retrieve, search, read, send, reply, flag, star, delete, label, and attachments. Missing operations like remove_label, create_label, or draft management are notable but not critical gaps for a full Gmail surface.