Skip to main content
Glama
message-container

message-container

by B-HS

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/Messages read-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 proxy

  • MCP: 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) # 웹 :32000

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables 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.
      10
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Read-only MCP server for local macOS Messages database, enabling querying of chats, messages, attachments, and metadata.
      7
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables 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
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables 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