Skip to content
Agentmart
Submit a tool

Gmail MCP Server

Lean Gmail MCP server with auto authentication support

Connector by ArtyMcLabin · GitHub account verified by the MCP Registry

IndexedMITLocal (stdio)★ 250
Write a review

Install

Works with Claude Code, Codex, VS Code, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.

npx agentmarket install connector/artymclabin-gmail-mcp-server

Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.

Get the weekly diff

The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.

We use your email only for this newsletter. Privacy

About

Lean Gmail MCP server with auto authentication support

Reviews

Write a review

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this server can do and what it asks for, from its tool list, install config and code. Checked Oct 25, 2026.

Tools
10 read · 9 write · 12 delete
Secrets
None asked for
Install scripts
None found
Runs as
Node.js package

Tools by what they do 31

Read from the source code; the running server may list different tools.

Read 10 · Look things up without changing anything.

  • download_attachment
  • download_email
  • get_filter
  • get_inbox_with_threads
  • get_thread
  • list_email_labels
  • list_filters
  • list_inbox_threads
  • read_email
  • search_emails

Write 9 · Create, change, send or run things.

  • create_filter
  • create_filter_from_template
  • create_label
  • draft_email
  • get_or_create_label
  • reply_all
  • send_email
  • send_emailEval
  • update_draft

Delete 12 · Delete, drop, revoke or wipe things.

  • batch_delete_emails
  • batch_modify_emails
  • batch_report_phishing
  • delete_draft
  • delete_email
  • delete_filter
  • delete_label
  • modify_email
  • modify_thread
  • report_phishing
  • send_draft
  • update_label

Secrets and settings it asks for

Other settings (environment variables or headers).

  • GMAIL_CREDENTIALS_PATH
  • GMAIL_OAUTH_PATH

Network hosts it talks to 4

  • github.com · found in code
  • glama.ai · found in code
  • googleapis.com · found in code
  • mail.google.com · found in code

Files it touches

  • Your home directory (~)
  • Any path the agent passes to its tools

Tools (31)

Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].

  • batch_delete_emailsBatch Delete Emailscan change or delete data

    Permanently deletes multiple emails in batches. Requires gmail.full because Gmail's batchDelete endpoint is not covered by gmail.modify.

  • batch_modify_emailsBatch Modify Emailscan change or delete data

    Modifies labels for multiple emails in batches

  • batch_report_phishingBatch Report Phishingcan change or delete data

    Reports multiple messages as phishing using the closest public Gmail API behavior by applying the SPAM label

  • create_filterCreate Filter

    Creates a new Gmail filter with custom criteria and actions

  • create_filter_from_templateCreate Filter from Template

    Creates a filter using a pre-defined template for common scenarios

  • create_labelCreate Label

    Creates a new Gmail label

  • delete_draftDelete Draftcan change or delete data

    Deletes a draft. Use to discard an abandoned or superseded draft.

  • delete_emailDelete Emailcan change or delete data

    Permanently deletes an email. Requires gmail.full because Gmail's delete endpoint is not covered by gmail.modify.

  • delete_filterDelete Filtercan change or delete data

    Deletes a Gmail filter

  • delete_labelDelete Labelcan change or delete data

    Deletes a Gmail label

  • download_attachmentDownload Attachmentread-only

    Downloads an email attachment to a specified location

  • download_emailDownload Emailread-only

    Downloads an email to a file in various formats (json, eml, txt, html). Returns metadata only - useful for saving emails without consuming context.

  • draft_emailDraft Email

    Evaluates the tool ability to draft an email

  • get_filterGet Filterread-only

    Gets details of a specific Gmail filter

  • get_inbox_with_threadsGet Inbox with Threadsread-only

    Convenience tool that lists threads and optionally expands each with full message content. One call returns the full inbox with complete thread bodies.

Show 16 more tools
  • get_or_create_labelGet or Create Label

    Gets an existing label by name or creates it if it doesn't exist

  • get_threadGet Threadread-only

    Retrieves all messages in an email thread in one call. Returns messages ordered chronologically (oldest first) with full content, headers, labels, and attachment metadata.

  • list_email_labelsList Email Labelsread-only

    Retrieves all available Gmail labels

  • list_filtersList Filtersread-only

    Retrieves all Gmail filters

  • list_inbox_threadsList Inbox Threadsread-only

    Lists email threads matching a query (default: inbox). Returns thread-level view with snippet, message count, and latest message metadata.

  • modify_emailModify Emailcan change or delete data

    Modifies email labels (move to different folders)

  • modify_threadModify Threadcan change or delete data

    Modifies labels on ALL messages in a thread atomically using the Gmail threads.modify endpoint. Use this instead of modify_email when you want to apply label changes (e.g., archive, mark as read) to an entire thread at once.

  • read_emailRead Emailread-only

    Retrieves the content of a specific email

  • reply_allReply All

    Replies to all recipients of an email. Automatically fetches the original email to build the recipient list (To, CC) and sets proper threading headers.

  • report_phishingReport Phishingcan change or delete data

    Reports a message as phishing using the closest public Gmail API behavior by applying the SPAM label

  • search_emailsSearch Emailsread-only

    Searches for emails using Gmail search syntax

  • send_draftSend Draft

    Sends an existing draft (created via draft_email) and atomically removes it from Drafts. Prefer this over send_email when you've previously created a draft for review — avoids leaving an orphan draft in the user's Drafts folder.

  • send_emailSend Email

    Sends a new email. Supports plain text, HTML, file attachments, and images embedded inline in the HTML body via inlineImages.

  • send_emailEval

    Evaluates sending a new email

  • update_draftUpdate Draft

    Replaces the content of an existing draft. Use during iteration ("change this and that") instead of creating a new draft each time — avoids accumulating draft copies in the user's Drafts folder.

  • update_labelUpdate Labelcan change or delete data

    Updates an existing Gmail label

Signals

Stars
250
Forks
62
Open issues
3
Weekly downloads
230
Last commit
Aug 12, 2026 (2 months ago)
Last release
Jul 11, 2026 (3 months ago)
Last package publish
Jul 10, 2026 (3 months ago)

From GitHub (fetched Oct 24, 2026) and the package registry.

Details

Registry name
io.github.ArtyMcLabin/Gmail-MCP-Server
Version
1.2.3
Auth
No auth
Packages
npm @artymclabin/gmail-mcp
License
MIT
Repository
github.com/ArtyMcLabin/Gmail-MCP-Server
First seen
Oct 24, 2026
Last checked
Oct 25, 2026
Source
Official MCP Registrygithub-graphql
Cite this page

Gmail MCP Server. Agent Mart. https://agentmart.dev/connectors/artymclabin-gmail-mcp-server (last updated 2026-10-25)