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-rich-search
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) # 웹 :32000This server cannot be installed
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
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.20710MIT
- AlicenseAqualityCmaintenanceEnables full-text search of macOS iMessages including link preview metadata. Works as an MCP server for Claude Desktop to search your messages locally.1MIT
- AlicenseNot gradedqualityCmaintenanceRead-only MCP server for local macOS Messages database, enabling querying of chats, messages, attachments, and metadata.207MIT
- AlicenseAqualityCmaintenanceA read-only MCP server that lets AI search a user's own LINE Desktop chat history on macOS, providing tools to list chats, retrieve messages, and search conversations directly from the local encrypted database.5MIT
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
Search, read, and write your Apple Notes from ChatGPT/Claude via a local Mac agent + MCP relay.
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/B-HS/message-container'
If you have feedback or need assistance with the MCP directory API, please join our Discord server