Skip to content
MCP server

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.

How AIPoweredBot checks servers