SSyncDev

MCP Hey MCP Server

A local MCP server providing Claude with read/write access to Hey.com email accounts via reverse-engineered web APIs.

Local serverstdioPython

What is the MCP Hey MCP Server?

A local MCP server providing Claude with read/write access to Hey.com email accounts via reverse-engineered web APIs.

The short version

mcp-hey has two moving parts: a Bun/TypeScript MCP server that exposes Hey tools over stdio, and a small Python helper that uses the system webview to capture session cookies at login. Everything runs locally — no cloud relay, no credentials stored, just session cookies on disk.

  • Read emails from Imbox, Feed, Paper Trail, Set Aside, Reply Later, Drafts, Trash, and Spam
  • Download attachments and parse calendar invites from emails
  • Send and reply to email threads
  • Search emails across boxes
  • Organise mail (set aside, reply later, screen in/out, bubble up)
  • Local SQLite cache for faster repeated reads and full-text search

What it needs from you

  • Bun 1.1 or later - Python 3.10 or later (plus UV if you want to follow the Python tooling in CLAUDE.md) - A Hey.com account - Platform: developed and tested on macOS and Linux. Windows users will likely need WSL — pywebview's Windows backend is not currently exercised.

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
CategoryTools
Readhey_list_emails (imbox, feed, paper_trail, trash, spam, drafts, sent), hey_imbox_summary, hey_list_set_aside, hey_list_reply_later, hey_list_screener, hey_read_
Sendhey_send_email, hey_reply, hey_forward
Triagehey_set_aside, hey_unset_aside, hey_reply_later, hey_remove_reply_later, hey_move_to, hey_set_status, hey_mark_unseen, hey_mark_seen, hey_read_status, hey_threa
Screenerhey_screen, hey_screen_by_id
Searchhey_search
Cachehey_cache_status

How to install the MCP Hey MCP Server

{
  "mcpServers": {
    "hey": {
      "type": "stdio",
      "command": "bun",
      "args": [
        "run",
        "/absolute/path/to/mcp-hey/src/index.ts"
      ]
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

  • Bun 1.1 or later - Python 3.10 or later (plus UV if you want to follow the Python tooling in CLAUDE.md) - A Hey.com account - Platform: developed and tested on macOS and Linux. Windows users will likely need WSL — pywebview's Windows backend is not currently exercised.

Example prompts to try

  • “Use MCP Hey to Category.”
  • “Use MCP Hey to Read.”
  • “Use MCP Hey to Send.”

Frequently asked questions

A local MCP server providing Claude with read/write access to Hey.com email accounts via reverse-engineered web APIs. Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.

Alternatives to the MCP Hey MCP Server

Slack Archived Reference

Your assistant inside the workspace — read channels, search history, post messages and tame the noise.

CommunicationTypeScript★ 63.0k

Fonoster

Build a programmable telecommunications stack for connecting telephony services with the Internet via a cloud-based utility.

AI & ML ServicesTypeScript★ 8.1k

geoly-mcp

The official remote MCP server for GEOly — AI brand visibility (GEO) for your agent. GEOly tracks how brands are mentioned and cited across AI engines (ChatGPT, Perplexity, Google AI Mode, Google AI…

Analytics & ReportingRemote

Buttondown

MCP server for Buttondown email newsletter API

Communication

Telegram Bridge

A small stdio Model Context Protocol server that sits between your local agent (Cursor, Claude Desktop, Windsurf, Grok/Cursor agents, and others) and the Telegram Bot API. The agent owns conversation logic; this…

Communication

Misarmail MCP

MisarMail MCP server — send email, run campaigns, manage contacts and automations, A/B test, and audit deliverability from Claude, Cursor, VS Code

CommunicationRemote