Skip to content
Agentmart
Submit a tool

Mailbox MCP

Multi-account email MCP server for Gmail, IMAP, and JMAP: search, send, drafts, labels.

Connector by jgalea · GitHub account verified by the MCP Registry

IndexedMITLocal (stdio)★ 10
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/jgalea-mailbox-mcp

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

Multi-account email MCP server for Gmail, IMAP, and JMAP: search, send, drafts, labels.

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
14 read · 21 write · 9 delete · 5 not yet classified
Secrets
1 (API keys, tokens or passwords)
Install scripts
None found
Runs as
Node.js package

Tools by what they do 49

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

Read 14 · Look things up without changing anything.

  • count_unread_by_label
  • get_signature
  • get_vacation
  • inbox_summary
  • list_accounts
  • list_drafts
  • list_filters
  • list_labels
  • list_recent_bulk_ops
  • list_send_as
  • list_templates
  • read_email
Show 2 more tools
  • read_thread
  • search_emails

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

  • authenticate
  • bulk_unsubscribe
  • create_draft
  • create_filter
  • create_label
  • download_attachment
  • emails_since
  • export_email
  • forward_email
  • mark_read
  • reply_email
  • save_template
Show 9 more tools
  • send_draft
  • send_email
  • send_template
  • set_signature
  • set_vacation
  • star_email
  • trash_emails
  • unsubscribe
  • update_draft

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

  • archive_email
  • batch_modify_emails
  • bulk_modify
  • delete_draft
  • delete_filter
  • delete_label
  • delete_template
  • modify_email
  • remove_account

Not yet classified 5 · We could not tell from the name and description.

  • bulk_trash
  • export_thread
  • multi_account_search
  • reauth
  • undo_bulk_op

Secrets and settings it asks for

Secrets: values you paste in that let it act as you.

  • MAILBOX_MCP_PASSPHRASE

Network hosts it talks to 3

  • api.typesafe.ai · found in code
  • github.com · found in code
  • googleapis.com · found in code

Files it touches

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

Tools (49)

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

  • archive_email

    Archive an email (remove from inbox). Gmail removes the INBOX label; IMAP moves to the Archive folder; JMAP moves out of the inbox mailbox.

  • authenticate

    Add a new email account. Refuses an alias that already exists (edit accounts.json or use reauth). For Gmail: opens a browser for OAuth. For IMAP/JMAP: stores encrypted credentials. Sensitive fields (username, password) can also be set via environment variables.

  • batch_modify_emails

    Add or remove labels/flags on multiple messages

  • bulk_modify

    Add or remove labels on all messages matching a query. Same fast search-then-batch pattern as bulk_trash, but for arbitrary label ops. Use this for archive (remove_labels=['INBOX']), bulk star/unstar, mark-read across a label, moving messages between labels, etc. Use dry_run to see the count first.

  • bulk_trash

    Trash all messages matching a query. Paginates the search and batch-trashes the IDs in one call. Use dry_run to see the count before committing. Useful for label cleanups (e.g. trash everything in 'Newsletters' or older than 90 days).

  • bulk_unsubscribe

    Find unsubscribe links for multiple mailing list messages

  • count_unread_by_label

    Count unread messages per label/folder. Useful for deciding where to look first.

  • create_draft

    Create a draft email

  • create_filter

    Create a Gmail filter

  • create_label

    Create a new label (Gmail) or folder (IMAP)

  • delete_draft

    Permanently delete a Gmail draft. This cannot be undone.

  • delete_filter

    Delete a Gmail filter

  • delete_label

    Delete a label (Gmail) or folder (IMAP)

  • delete_template

    Delete a saved template

  • download_attachment

    Download an email attachment to a safe directory

Show 34 more tools
  • emails_since

    List messages received after a given timestamp. Use for polling new mail since a last-check marker.

  • export_email

    Export an email as a raw RFC 822 .eml file to a safe directory. Useful for archival, legal discovery, or migration.

  • export_thread

    Export all messages in a thread as individual .eml files to a safe directory. Gmail/JMAP only.

  • forward_email

    Forward an email message to new recipients. Forwarding outside the account's own domain needs confirm_external_forward; recipients the account has never written to need confirm_new_recipient. On draftsOnly accounts a forward draft is created instead.

  • get_signature

    Get the email signature for a Gmail account

  • get_vacation

    Get vacation auto-reply settings

  • inbox_summary

    Get a summary of recent inbox activity including total and unread counts. When a TypeSafe API key is configured, each recent message is also triaged (needs reply, FYI, newsletter, receipt, notification, suspicious) by the Jev decision model.

  • list_accounts

    List all configured email accounts with their provider type and email address

  • list_drafts

    List drafts for an account

  • list_filters

    List Gmail filters

  • list_labels

    List all labels (Gmail) or folders (IMAP) for an account

  • list_recent_bulk_ops

    List recent bulk_modify and bulk_trash operations recorded in the transaction log. Use to find an op id for undo_bulk_op.

  • list_send_as

    List send-as aliases configured on a Gmail account

  • list_templates

    List saved email templates

  • mark_read

    Mark an email as read or unread

  • modify_email

    Add or remove labels/flags on a message

  • multi_account_search

    Run the same search across all configured accounts in parallel. Returns results grouped by account alias.

  • read_email

    Read a single email message with full content

  • read_thread

    Read an entire email conversation thread (Gmail and JMAP only)

  • reauth

    Re-run OAuth for an existing Gmail account without removing it. Opens a browser for Google sign-in. Use when the refresh token expires (invalid_grant) or scopes change.

  • remove_account

    Remove a configured email account and its stored credentials. Refuses for an account with any safety setting; those are removed by editing accounts.json.

  • reply_email

    Reply to an email message. Extra cc/bcc addresses the account has never written to need confirm_new_recipient. On draftsOnly accounts a reply draft is created instead.

  • save_template

    Save an email template (stored as a Gmail draft with TEMPLATE label)

  • search_emails

    Search emails in an account. Gmail supports full Gmail search syntax. IMAP searches subject and body. Optional folder parameter scopes the search to a specific label/folder.

  • send_draft

    Send an existing draft as-is. Runs the same recipient guards as send_email. For Gmail/JMAP the draft is finalised and submitted; for IMAP the message is sent via SMTP and removed from the Drafts folder.

  • send_email

    Send a new email. Refuses new recipients without confirm_new_recipient, and creates a draft instead on accounts configured draftsOnly.

  • send_template

    Send an email using a saved template

  • set_signature

    Update the email signature for a Gmail account

  • set_vacation

    Configure vacation auto-reply

  • star_email

    Star or unstar an email

  • trash_emails

    Move messages to trash

  • undo_bulk_op

    Reverse a previously recorded bulk_modify or bulk_trash by replaying the inverse label change against the exact ids that were touched. Find the op id from list_recent_bulk_ops. Idempotent on already-reversed ops (refuses to re-reverse).

  • unsubscribe

    Unsubscribe from a mailing list by finding the List-Unsubscribe header

  • update_draft

    Replace the contents of an existing Gmail draft. The draft's thread association is preserved automatically.

Compare and alternatives

    Featured in

    Signals

    Stars
    10
    Forks
    12
    Open issues
    1
    Last commit
    Oct 11, 2026 (17 days ago)
    Last release
    Oct 10, 2026 (18 days ago)

    From GitHub (fetched Oct 24, 2026).

    Details

    Registry name
    io.github.jgalea/mailbox-mcp
    Version
    0.13.1
    Auth
    API key
    Packages
    npm mailbox-mcp
    License
    MIT
    Repository
    github.com/jgalea/mailbox-mcp
    First seen
    Oct 24, 2026
    Last checked
    Oct 24, 2026
    Source
    Official MCP Registrygithub-graphql

    More from jgalea

    Cite this page

    Mailbox MCP. Agent Mart. https://agentmart.dev/connectors/jgalea-mailbox-mcp (last updated 2026-10-24)