message-container
Provides read-only access to macOS Messages (iMessage) chat history, enabling search, retrieval, and analysis of messages from the local chat database.
message-container
Docker container monorepo that reads macOS Messages (chat.db) and provides a query API, web dashboard, and MCP.
apps/server— Bun + Hono + Drizzle API server. Mounts~/Library/Messagesread-only and incrementally syncs to its own DB (MySQL default · SQLite · PostgreSQL). Query-only (no sending)apps/web— Next.js (App Router) + shadcn + Tailwind v4 web dashboard. Renders data from first paint via server prefetch + Hydration, applies the flunti-otel design system (square · flat · 1px stroke)Security: When the initial password is set from the web, the server issues a
msg_API key, and the web stores it in an httpOnly cookie and calls the API only through a proxyMCP: AI clients connect to
/mcp(Streamable HTTP) with the same API key
Quick start
./scripts/smoke-test.sh # docker compose 기동 + 상태 확인 (docker 만 있으면 됨)
open http://localhost:32000 # 웹에서 초기 패스워드 설정 → 대시보드First, you must grant Full Disk Access to Docker Desktop/OrbStack to read the actual chat.db. See docs/setup.md for detailed procedures, docs/api.md for API specs, docs/mcp.md for the MCP guide, and docs/architecture.md for the structure.
Related MCP server: iMessage MCP
Development
bun install
bun run typecheck # 전체 워크스페이스
bun run test # 전체 워크스페이스
(cd apps/server && bun run dev) # API :33000
(cd apps/web && MESSAGE_API_URL=http://localhost:33000 bun run dev) # 웹 :32000Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Search your AI chat history (ChatGPT, Claude, Codex) from any MCP client. Remote, private, read-only
MCP connector for iMessage & Contacts via a local Mac agent + Vercel relay
Explore your Messages SQLite database to browse tables and inspect schemas with ease. Run flexible…
Read, search and manage iCloud Mail, Calendar and Contacts from Claude and other MCP clients.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables reading, searching, and sending iMessages directly from MCP-compatible clients by accessing the local macOS iMessage database, supporting conversations, attachments, and both individual and group chats.10MIT
- AlicenseAqualityCmaintenanceRead-only MCP server for local macOS Messages database, enabling querying of chats, messages, attachments, and metadata.7MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI agents to read the entire Apple Messages (iMessage/SMS) history on a Mac through a read-only, batched tool that supports listing chats, retrieving transcripts, polling recent messages, and searching message bodies via REST or streamable HTTP MCP.MIT
- AlicenseNot gradedqualityCmaintenanceEnables MCP-capable AI clients to search both sides of a user's own macOS LINE Desktop chat history — listing chats, reading messages, searching text, and pulling recent activity from local read-only database snapshots. It never sends messages, marks chats read, clicks through the UI, or requires a LINE Official Account.MIT