What it does
MCP connector for iMessage & Contacts via a local Mac agent + Vercel relay
- Connects クラウドで動く
- Account or key No key needed
- Category 開発者ツール
一緒に使える
この種の作業を AI に教える Skill。これと一緒に使えます
andrej-karpathy-skills
A single CLAUDE.md file to improve Claude Code behavior, derived from Andrej Karpathy's observations on LLM coding pitfalls.
graphify
Turn any codebase, with its docs, SQL schemas, configs, and PDFs, into a queryable knowledge graph. A /graphify skill for Claude Code, Cursor, Codex, and Gemini CLI: local deterministic AST parsing, every edge explained, no vector store.
この順位の理由
一覧は利用スコア(100 点満点)で並びます。内訳は次のとおり
| 人気 | 0/80 | GitHub スターか週間ダウンロード数。大きい方を 60、小さい方を 20 で数えます |
|---|---|---|
| 新しさ | 7/12 | 30 日以内のリリースかコード更新で満点 |
| 応答中 | 0/8 | 前回の確認でクラウドのエンドポイントが応答 |
| 利用スコア | 7/100 |
品質: 基本チェック 3/4 項目に合格(表示のみ、並び順には不使用) · 勢い: データなし (「急上昇」タブでのみ使用)
インストール
使っているAIアプリを選んで、設定をコピーしてください。
チェック 3/4 合格 · あなたのパソコンで動きます
一部のコマンドを隠しています
URL でつなぐ:確認時にサーバーのアドレスが応答しませんでした
確認を通った方法がまだありません。作者の説明を見るか、同じカテゴリの別のサーバーを選んでください · 作者のインストール手順 · 同じカテゴリのほかのサーバー
まず:どの AI を使っていますか?
使っているアプリを選ぶと、下に手順が表示されます。
Claude はまだ Messages Bridge につなげません
確認を通った方法がまだありません。作者の説明を見るか、同じカテゴリの別のサーバーを選んでください
ChatGPT はまだ Messages Bridge につなげません
確認を通った方法がまだありません。作者の説明を見るか、同じカテゴリの別のサーバーを選んでください
代わりにできること
B · 開発者ツール の中で ChatGPT につなげる別のサーバー
同じカテゴリでよく使われているものから、キーなしでアドレスだけでつなげるものを選びました
- Sentry✓ ChatGPT
- Compiler Explorer✓ ChatGPT
- GitDiagram✓ ChatGPT
Claude Code はまだ Messages Bridge につなげません
確認を通った方法がまだありません。作者の説明を見るか、同じカテゴリの別のサーバーを選んでください
Cursor はまだ Messages Bridge につなげません
確認を通った方法がまだありません。作者の説明を見るか、同じカテゴリの別のサーバーを選んでください
VS Code はまだ Messages Bridge につなげません
確認を通った方法がまだありません。作者の説明を見るか、同じカテゴリの別のサーバーを選んでください
確認を通った方法がまだありません。作者の説明を見るか、同じカテゴリの別のサーバーを選んでください
ひと目でわかる
使えるアプリ
このサーバーのつなぎ方と、各アプリの公式ドキュメントに基づきます。2026年11月10日に確認。
インターネット経由でつなげるアプリ
GooseLM StudioMsty StudioCherry StudioVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatOpen WebUIRaycast
できること
前回チェックしたときにサーバーが応答しなかったため、ツールを読み取れませんでした。
基本チェックi
誰でも見られる情報をチェックしており、コードは読んでいません。当てはまらない項目は数に入れていません。 · 2026年11月19日にチェック
- ✓ 合格
作者とリポジトリが一致
レジストリ名は、リポジトリを所有するGitHubアカウント IsaiahDupree で確認済みです
- ✓ 合格
今もメンテナンスされている
コードの最終更新:32 日前
- ✓ 合格
ライセンスがある
MITを使用
- ✕ 不合格
エンドポイントが応答する
チェックしたとき、6秒以内に応答がありませんでした
- – 対象外
OAuthでサインイン
チェックしたとき、6秒以内に応答がありませんでした
- … 未チェック
ツールの説明に隠れた指示がない
まだチェックしていません。エンドポイントをチェックするときにツール一覧を読み取ります
作者の方へ:再確認の依頼・情報の誤りの報告
作者向け:README にバッジを付ける
作者の方は、このコードを README に貼れます。バッジはこのページにリンクします。
[](https://mcp.popnx.com/en/servers/isaiahdupree-messages-bridge)話し合い
質問、コツの共有、使えないことの報告ができます。「役に立った」の多い順です。
ユーザーレビュー
まだレビューはありません
開発者ツールのほかのサーバーとの比較i
- このカテゴリのほかの6116件のうち0%よりスターが多い
- このカテゴリのほかの6116件のうち23%より最近レジストリに公開
- 基本チェックの結果が、このカテゴリのほかの6116件のうち46%と同じかそれ以上
レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。
よくある質問
Messages Bridgeは安全ですか?
当てはまる基本チェック4項目のうち3項目に合格しました。コードは読んでいません。キーやトークンを追加する前に、サーバーがどんなアクセスを求めているかを確認し、必要な権限だけを持つキーを使ってください。
どんなキーやコードが必要ですか?
レジストリには必須のキーは載っていません。ただし、最初に使うときにサインインを求めるサーバーもあります。
パソコンで動きますか、それともクラウドですか?
作者のクラウドで動きます。インストール不要でインターネット経由でつながりますが、送った内容は作者のサーバーを通ります。
今もメンテナンスされていますか?
GitHubリポジトリの最終更新は32 日前、最新バージョン(1.3.0)がレジストリに届いたのは4 か月前です。
どのアプリで使えますか?
Claude Desktop、Claude Code、Cursor、VS CodeなどのMCP対応アプリで使えます。URL で接続するので、リモート MCP を受け付けるアプリでも使えます。例:Web 版 ChatGPT(Business 以上はフル MCP、Pro は読み取りのみ)。
代わりに使えるものは?
同じカテゴリには:GitDiagram, Appllama, Cloudflare MCP, Omnara, Repowise
似た働きのほかの候補
同じカテゴリでほかの作者のもの。コマンドは確認済み。公式を先に、次にスター順。
カードの見方:↓ 週あたりのダウンロードi★ GitHubスターi3つの柱:レビュー · チェック · 利用状況i更新=最新バージョンをレジストリに公開した日i
GitDiagram
Architecture diagrams, explanations and Mermaid source for public GitHub repositories.
Appllama
Study screens, flows and paywalls from top-earning iOS apps, then build from what wins.
Omnara
Deploy durable AI agents with Omnara, an open-source managed-agent platform.
Repowise
Codebase intelligence for AI coding agents: graph, git history, docs, decisions, code health.
| これ Messages Bridge | GitDiagram | Appllama | Cloudflare MCP | Omnara | Repowise | |
|---|---|---|---|---|---|---|
| 動く場所 | クラウドで動き、インストール不要 | クラウドで動き、インストール不要 | クラウドで動き、インストール不要 | クラウドで動き、インストール不要 | クラウドで動き、インストール不要 | クラウドでもパソコンにインストールでも使える |
| キーが必要 | いいえ | いいえ | いいえ | いいえ | いいえ | いいえ |
| Claude で + から追加 | いいえ | いいえ | いいえ | はい | いいえ | いいえ |
| 基本チェック | 3/4 | 4/4 | 4/4 | 4/4 | 4/4 | 5/5 |
| ライセンス | MIT | MIT | MIT | Apache-2.0 | Apache-2.0 | AGPL-3.0 |
| 料金 | 登録情報に費用の記載なし | 登録情報に費用の記載なし | 登録情報に費用の記載なし | 登録情報に費用の記載なし | 登録情報に費用の記載なし | 登録情報に費用の記載なし |
作者のREADME
READMEを開く
作者のリポジトリから書かれたとおりにコピーしたものです。PopNx MCPは内容を確認・推奨していません。HTML、画像、スクリプトは取り除いています。リンクはこのサイトの外へ移動します。
💬 MessagesBridge
Use your iMessage & Contacts inside ChatGPT — through your own Mac.
MessagesBridge is a Model Context Protocol (MCP) connector that lets ChatGPT work with your iMessage conversations and Contacts. Reads execute on your own Mac through a small local agent. Requested results pass through the hosted relay and are returned to ChatGPT. The relay temporarily stores request/result payloads in its queue; it does not maintain a permanent copy of your message history.
ChatGPT ──OAuth──► MessagesBridge relay ──job queue──► apple-messages-agent ──► Messages.app + Contacts
(connector) (Vercel, stateless) (your Mac, polls & executes) (on your Mac)
Your Mac is the only place your messages are ever read or contacts written. The relay stores only short-lived job payloads and your account record; it never sees a message unless a job is in flight, and queue payloads have short expiry windows.
For users — 3 steps
1. Create your account at [messagesbridge.vercel.app](https://messagesbridge.vercel.app) and generate a pairing code.
2. Install the Mac agent (needs Node 18+ and Apple Command Line Tools):
npx apple-messages-agent pair <YOUR-CODE> # link this Mac to your account
npx apple-messages-agent install # keep it running on every restart
The agent needs two macOS permissions, granted once: Full Disk Access so it can *read* your message history (System Settings → Privacy & Security → Full Disk Access), and Automation the first time it *sends* a message or reads Contacts — macOS asks "Terminal wants to control Messages" and to access Contacts; click OK.
3. Connect ChatGPT: Settings → Plugins → turn on Developer mode (Security & login) → Create a custom plugin → paste the MCP Server URL `https://messagesbridge.vercel.app/mcp` → Authentication OAuth → sign in & Allow.
That's it. In a new chat: *"Search my messages for the dinner plans"* or *"Text Sarah that I'm running 10 minutes late."* (You confirm every send before it goes out.)
Your Mac must be awake with the agent running.
npx apple-messages-agent installmakes it start automatically at login and restart if it ever crashes.
Managing the agent
npx apple-messages-agent status # is it paired & reachable?
npx apple-messages-agent logs # recent activity npx apple-messages-agent uninstall # stop auto-start
What ChatGPT can do
| Tool | Action |
|---|---|
search_messages | Search plain and Apple attributed text; follow next_cursor even on empty result pages |
list_recent_threads | List recent conversations, newest first, with a last-message preview |
get_thread | Read pages of one conversation using an exact chat id; pass next_cursor as cursor until null |
messages_status | Check local access, counts and coverage without returning message content |
send_message | Send an iMessage to one recipient (you confirm first — no bulk) |
search_contacts | Find people by name (returns their phones + emails) |
get_contact | Read one contact by name or id |
create_contact | Add a contact (name, optional phone/email) |
Reads come first; the only write tools are send_message and create_contact, and each is confirmed by you in ChatGPT before it runs. Sends always go to one recipient at a time — never in bulk.
Self-hosting
You can run your own relay so nothing depends on the hosted instance.
Prereqs: a Vercel account and a Supabase project (free tiers are fine).
- Storage — in your Supabase project's SQL editor, run
supabase/schema.sql. It creates isolatedactp_messagesbridge_*tables andmb_*storage functions with RLS and service-role-only grants. - Deploy the
server/directory to Vercel. - Set env vars (see
server/.env.example):
SUPABASE_URL,SUPABASE_SERVICE_ROLE_KEY— your project + service-role keyJWT_SECRET—openssl rand -hex 32
- Verify:
curl https://YOUR-APP.vercel.app/api/health→redisConfigured,redisOk,jwtSecretSetalltrue. - Point the agent at it:
npx apple-messages-agent pair --server https://YOUR-APP.vercel.app.
How it works
- Auth — OAuth 2.1 with PKCE and Dynamic Client Registration (RFC 7591). ChatGPT registers itself, the user signs in on the MessagesBridge consent page, and ChatGPT gets a scoped MCP access token. JWTs are HMAC-signed; three kinds (
session,agent,mcp) with distinct privileges. Optional email verification via Resend (RESEND_API_KEY); off unless configured, and enforcement is opt-in (REQUIRE_EMAIL_VERIFICATION). - Relay — MCP tool call → job pushed to
jobs:(TTL ≤ the caller's wait window, so an abandoned job can't run late) → the Mac agent (holding a hanging long-poll) is handed the job within ~200ms, executes it, pushes the result → the MCP handler returns it. The long-poll means jobs are delivered on arrival rather than on a fixed interval, so relay overhead is ~300ms instead of ~1s. The agent is considered "online" only while it's actively connected. - Agent — a dependency-free Node CLI. Read tools query the Messages
chat.dbdirectly (read-only SQLite); send and contact tools run via JXA (osascript -l JavaScript) against Messages.app and Contacts; arguments are passed as JSON over argv (never shell-interpolated). A macOS LaunchAgent keeps it alive across logins and crashes.
Repository layout
server/ Vercel functions: OAuth + MCP endpoint + relay (deploy this)
agent/ apple-messages-agent — the npm-published Mac CLI (users npx this) kit/ Browser automations: register the dev-mode connector AND fill the OpenAI directory submission (see kit/README.md) supabase/ schema.sql for self-hosting the storage test/ end-to-end OAuth + MCP integration test
Development
# server
cd server && cp .env.example .env.local # fill in, then: vercel dev
end-to-end test against a live deployment (reads ../.env.local)
node test/e2e-oauth.mjs
agent unit tests
node --test agent/test-agent-unit.mjs
Security & privacy
- Messages are read and sent, and contacts read and added, only on your Mac. The relay temporarily persists requested content in its job/result queues with short TTLs; results are consumed on delivery.
- The agent token is stored at
~/.messagesbridge-agent.json(mode600). - No secrets are committed; see
.gitignoreand the.env.examplefiles. - Write tools are marked destructive so ChatGPT asks before it sends a message or adds a contact — every send goes to one confirmed recipient at a time, never in bulk.
License
MIT © Isaiah Dupree
Verified read coverage and live tests
Agent 1.1 reads the live SQLite WAL, decodes Apple attributed strings using macOS Foundation, and provides bounded cursor pagination. Cursors follow database insertion order. Attachment-only records remain visible through has_attachments; attachment files are not uploaded or decoded. The Mac database is the coverage boundary: this does not establish that every iPhone/iCloud message has synced.
apple-messages-agent doctor
node test/live-messages.mjs
After pairing your own account and starting the agent:
MB_EMAIL=your-email MB_PASSWORD=your-password node test/live-relay.mjs
Provide credentials through your secure environment, not a shared transcript or committed file. The live tests only read and print aggregate results. live-messages checks every local conversation page, all messages in the largest thread, decoded search, and cursor validation. live-relay validates actual OAuth, MCP and paired-Mac reads; it fails if the Mac is offline. Reviewer/demo output is never accepted as evidence of a live integration.
Production requires the storage migration and valid Supabase configuration. /api/health returns HTTP 503 when storage is unavailable. If the old relay database is unavailable, accounts, pairing and OAuth sessions from it cannot be recovered automatically; sign in/create an owner account and reconnect the plugin.