Gmail

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/pulsemcp-com-gmail

About

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

4 read · 3 write · 1 delete

Secrets

4 (API keys, tokens or passwords)

Install scripts

None found

Runs as

Node.js package

Tools (8)

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

• change_email_conversation

  Modify an email conversation's status, labels, or starred state. **Parameters:** - email_id: The unique identifier of the email (required) - status: Mark as "read", "unread", or "archived" (optional) - labels: Comma-separated labels to add (optional) - remove_labels: Comma-separated labels to remove (optional) - is_starred: Set to true to star, false to unstar (optional) **Label operations:** - Adding STARRED marks the email as starred - Removing INBOX archives the email - Adding/removing UNREAD marks email as unread/read **Use cases:** - Mark an email as read/unread - Star important emails…

• download_email_attachments

  Download attachment content from a specific email. By default, saves all attachments to /tmp/ and returns the file paths. Use the inline parameter to return content directly in the response instead. **Parameters:** - email_id: The unique identifier of the email (required) - filename: Download only the attachment matching this filename (optional) - inline: If true, return content in the response instead of saving to files (optional, default: false) **Default behavior (inline=false):** Saves attachments as files to /tmp/ and returns the full file paths. Best for binary files or large attachme…

• get_email_conversation

  Retrieve the full content of a specific email conversation by its ID. Returns the complete email including headers, body content, and attachment information. **Parameters:** - email_id: The unique identifier of the email (required) - include_html: When true, includes raw HTML body in addition to plain text (optional) **Returns:** Full email details including: - Subject, From, To, Cc, Date headers - Full message body (plain text preferred, HTML as fallback) - Raw HTML body (when include_html is true and HTML content is available) - List of attachments (if any) - Labels assigned to the email …

• list_draft_emails

  List draft emails from Gmail. **Parameters:** - count: Maximum number of drafts to return (default: 10, max: 100) - thread_id: Filter drafts by conversation thread ID (optional) **Use cases:** - Discover existing drafts before creating a new one - Find a draft ID to pass to upsert_draft_email for updating - Check which drafts exist for a specific email conversation **Note:** Use the returned draft IDs with upsert_draft_email to update drafts, or with send_email's from_draft_id to send them.

• list_email_conversations

  List email conversations from Gmail. Returns a list of email conversations with their subject, sender, date, and a snippet preview. Use get_email_conversation to retrieve the full content of a specific conversation. **Parameters:** - count: Maximum conversations to return (default: 10, max: 100) - labels: Which labels/folders to search (default: INBOX) - sort_by: Sort order - "recent" (newest first) or "oldest" (default: recent) - after: Only return emails after this datetime, exclusive (ISO 8601 UTC, e.g., 2024-01-15T14:30:00Z) - before: Only return emails before this datetime, exclusive (I…

• search_email_conversations

  Search email conversations using Gmail's powerful search syntax. **Parameters:** - query: Gmail search query (required) - count: Maximum results to return (default: 10, max: 100) **Search operators:** - from:user@example.com - Emails from specific sender - to:user@example.com - Emails sent to specific recipient - subject:keyword - Emails with keyword in subject - is:unread / is:read - Unread or read emails - is:starred - Starred emails - has:attachment - Emails with attachments - filename:pdf - Emails with specific attachment type - after:2024/01/01 - Emails after a date - before:2024/12/31 …

• send_email

  Send an email immediately or send a previously created draft. **Option 1: Send a new email** - to: Recipient email address(es) (required) - subject: Email subject line (required) - plaintext_body: Plain text body content (at least one of plaintext_body or html_body required) - html_body: HTML body content for rich text formatting (at least one of plaintext_body or html_body required) - cc: CC recipients (optional) - bcc: BCC recipients (optional) - thread_id: Thread ID to reply to an existing conversation (optional) - reply_to_email_id: Email ID to reply to, sets proper reply headers (optiona…

• upsert_draft_email

  Create, update, or delete a draft email. **Parameters:** - draft_id: ID of an existing draft to update or delete (optional — omit to create a new draft) - delete: Set to true to delete the draft specified by draft_id (optional) - to: Recipient email address(es) (required for create/update) - subject: Email subject line (required for create/update) - plaintext_body: Plain text body content (at least one of plaintext_body or html_body required for create/update) - html_body: HTML body content for rich text formatting (at least one of plaintext_body or html_body required for create/update) - cc:…

Compare and alternatives

Featured in

• Best MCP servers for Gmail

Signals

Stars

81

Forks

10

Open issues

26

Contributors

4

Last commit (this folder)

Jul 10, 2026 (3 months ago)

Last release

Aug 30, 2026 (1 month ago)

From GitHub (fetched Oct 24, 2026).

Details

Registry name

com.pulsemcp/gmail

Version

0.4.12

Auth

API key

Packages

npm gmail-workspace-mcp-server

License

MIT

Repository

github.com/pulsemcp/mcp-servers

First seen

Oct 24, 2026

Last checked

Oct 24, 2026

Source

Official MCP Registrygithub-graphql