chatmux
Local MCP server exposing your LINE and Telegram chat history to AI clients
- Pricing
- Open source
- Platforms
- CLI, API, Linux
- Version
- 0.1.0
- Listing updated
- today
Similar MCP servers
About chatmux
chatmux is an open-source MCP server for communication. It is available on CLI, API, Linux, macOS and self-hosted.
The README describes chatmux as a local-first daemon that connects chat platforms through child-process adapters and keeps the messages on your own machine. Incoming messages are written to an append-only JSONL log and indexed in SQLite with FTS5 full-text search, which supports CJK text through a trigram index with a LIKE fallback.
The daemon serves an MCP interface over Streamable HTTP on 127.0.0.1 port 7717 and over a unix socket. Its eight tools cover listing chats, reading and searching messages, tailing an event cursor, sending messages through a rate-limited safety rail, and fetching cached media. Core stays neutral about which chats matter; the README points to a separate consumer layer for that, with a notifier example included.
The LINE adapter is the v0.1 default and relies on the unofficial @evex/linejs client, which the README flags as a risk to the account. A Telegram adapter lives in its own repository. The project suits developers who want their own AI assistant to read personal chat history locally, but the README stresses that decrypted messages and auth tokens are stored in plaintext in v0.1.
Tools this server provides (8)
Taken from the project documentation; the running server may differ.
- list_chats
- List chats with last message preview, search, pagination
- read_messages
- Read messages from a chat, paginated by timestamp
- read_events
- Tail the event log from an opaque cursor
- search_messages
- Full-text search over messages
- send_message
- Send message through SafetyRail
- get_media
- Local file path for a message's image or sticker
- probe_latest
- Diagnostic, read-only probe of a chat's newest messages
- get_status
- System status: adapter connection and storage stats
What it does
- Local message storage
- Messages are kept on disk as an append-only JSONL log with a SQLite/FTS5 index for queries.
- MCP tools for chats
- Eight tools cover listing chats, reading and searching messages, tailing events, sending, and fetching media.
- Pluggable platform adapters
- Platforms run as child-process adapters over a stdio JSON-RPC protocol, so new chat services can be added.
- Safety-railed sending
- Outgoing messages pass through a SafetyRail that applies rate limits and error tracking.
- Resumable event tail
- An opaque cursor lets consumers resume the event log and receive edits or retractions.
- systemd service support
- A bundled user unit runs the daemon with restart-on-crash behaviour.
Good for
- Letting an AI assistant search and summarise personal LINE or Telegram conversations
- Reading recent chat messages from inside Claude Code or a Neovim client
- Building a notifier that forwards selected incoming messages elsewhere
- Running a local chat archive with full-text search over CJK and other text
Pricing
Open source
MIT-licensed, self-hosted.
chatmux FAQ
Where is the data stored?
The README lists ~/.local/share/chatmux/ for events.jsonl, chatmux.db, and the adapter auth and storage files. Messages are stored in plaintext, and the database is not encrypted in v0.1.
Which platforms are supported?
v0.1 supports LINE through a built-in adapter. The README says Telegram is available through a separate adapter repository.
How do I connect it to Claude Code?
Run: claude mcp add --transport http chatmux http://127.0.0.1:7717/mcp
Does using it carry risk to my account?
The README warns that the LINE adapter uses an unofficial client that may violate LINE's terms and could lead to account restriction or a ban.
Is chatmux free?
Yes. chatmux is open source, so you can use and self-host it for free.
What are the best alternatives to chatmux?
The closest alternatives to chatmux are Stream MCP by usefulapi, Telegram MCP by usefulapi, Telegram (tg-mcp), Fast MCP Telegram and Chatroost — unofficial Telegram MCP server.
Where this comes from
- Description: written from the project's README and its MCP Registry entry.