广告合作
MCP.so
登录
M

MCP Hey

@Sealjay

代码仓库

基本信息

分类

其他

传输方式

stdio

作者

Sealjay

提交者

Chris Lloyd-Jones

关于 MCP Hey

Local MCP server for Hey.com email - read, search, send, reply, and manage the screener via stored session cookies. 41 tools over stdio. Runs entirely locally, stores no credentials.

MCP Hey 配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

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

MCP Hey 工具

6

`hey_list_imbox`, `hey_imbox_summary`, `hey_list_feed`, `hey_list_paper_trail`, `hey_list_set_aside`, `hey_list_reply_later`, `hey_list_screener`, `hey_list_trash`, `hey_list_spam`, `hey_list_drafts`, `hey_read_email`

`hey_send_email`, `hey_reply`, `hey_forward`

`hey_set_aside`, `hey_unset_aside`, `hey_reply_later`, `hey_remove_reply_later`, `hey_mark_unseen`, `hey_trash`, `hey_restore`, `hey_spam`, `hey_not_spam`, `hey_ignore_thread`, `hey_unignore_thread`

`hey_screen_in`, `hey_screen_in_by_id`, `hey_screen_out`

`hey_search`

`hey_cache_status`

概览

What is Mcp Hey?

Mcp Hey is a local Model Context Protocol (MCP) server that gives Claude read/write access to your Hey.com inbox via reverse-engineered web APIs. It consists of a Bun/TypeScript MCP server and a Python helper for authentication through a system webview, running entirely on your machine with no cloud relay.

How to use Mcp Hey?

Clone the repository, install dependencies with bun install and pip install -r auth/requirements.txt, then authenticate by running bun run dev and logging into Hey.com. Configure your MCP client (Claude Code, Claude Desktop, or Cursor) by adding the server with bun run /absolute/path/to/mcp-hey/src/index.ts as the command and args. For Docker, build the image and mount pre-existing session cookies.

Key features of Mcp Hey

  • Read emails from Imbox, Feed, Paper Trail, Set Aside, and Reply Later
  • Send, reply to, and forward email threads directly from Claude
  • Search emails across all boxes with full-text search
  • Organize mail with set aside, reply later, screen in/out, and bubble up
  • Local SQLite cache for fast repeated reads and search
  • Lightweight — around 30 MB idle memory with stdio transport

Use cases of Mcp Hey

  • Manage your Hey.com inbox entirely through Claude using natural language commands
  • Automate email triage: read, reply, set aside, or trash messages without leaving Claude
  • Search across Hey.com mailboxes for specific threads or contacts
  • Organize incoming email by applying labels, collections, or screening rules

常见问题

1

How does authentication work?

A Python auth helper opens a system webview pointed at Hey.com. You log in normally; session cookies are captured to `data/hey-cookies.json` with `600` permissions. No credentials are ever stored — only session cookies.

2

What happens when my session expires?

Delete `data/hey-cookies.json` and run `bun run dev` again to re-authenticate. Session validity is checked on startup and before sensitive operations.

3

Is this an official Hey.com API?

No. Mcp Hey reverse-engineers Hey.com's web endpoints and pairs them with browser-identical HTTP requests. Things can break without notice. The known API surface is documented in `docs/API.md`.

4

What are the main limitations?

- No real-time notifications — polling only. - Attachment uploads are not yet supported. - Single account per MCP server instance. - Prompt-injection risk: a malicious email could attempt to exfiltrate other messages. - Aggressive access patterns may trigger anti-abuse systems (rate limits are respected with exponential backoff).

评论

其他 分类下的更多 MCP 服务器

Handl

Handl speaks the Model Context Protocol. Your whole billing operation — projects, invoices, clients, reports, approvals — as tools any AI assistant can call, inside your autonomy rules.

ICSS

chokcoco

不止于 CSS

20.7K

🚀 Model Context Protocol (MCP) Curriculum for Beginners

microsoft

This open-source curriculum introduces the fundamentals of Model Context Protocol (MCP) through real-world, cross-language examples in .NET, Java, TypeScript, JavaScript, Rust and Python. Designed for developers, it focuses on practical techniques for building modular, scalable,

16.7K

Yuppsy

Yuppsy MCP: build and publish real estate websites from your AI assistant. Yuppsy lets your AI assistant create live websites for real estate agents and individual property listings. You don't need a designer or any code

Figs, Relationship Expert

Figs O'Sullivan, LMFT

Couples therapist Figs O'Sullivan (LMFT, 17 years, endorsed by Sue Johnson, creator of EFT) inside your AI. Ask relationship questions answered from his clinical writing, name the pattern in a fight, get a three-step rep

广告合作