signal-mcpl
Bridges Signal via a signal-cli daemon, exposing direct messages and group chats as channels, with tools for sending messages and reactions, handling attachments, and sending read receipts.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@signal-mcplSend 'Running late, be there soon' to the family group"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
signal-mcpl
An MCPL server bridging Signal via the
signal-cli daemon (HTTP JSON-RPC + SSE).
Exposes Signal DMs and group chats as MCPL channels, plus signal_send and
signal_react tools.
Conversation | Channel id | Tags |
DM |
|
|
Group |
|
|
Reaction | (either) |
|
The chat:addressed / chat:ambient split is the useful part for a host: DMs
are addressed to the agent and generally warrant waking it; group traffic is
ambient and can be archived for continuity without spending inference on every
message.
Requirements
Node >= 20
A running
signal-clidaemon with the HTTP JSON-RPC + SSE interface enabled
Related MCP server: mcp-signal
Usage
signal-mcpl --stdioConfiguration
All configuration is via environment variables. Nothing is hardcoded.
Variable | Default | Purpose |
|
| signal-cli daemon base URL |
| (unset) | Your own E.164 number; used to detect reactions to your own messages |
| (unset) | Your own account UUID, same purpose |
| (unset — open) | Comma-separated allowlist of UUIDs/numbers. Unset means no filtering. |
| (unset) | JSON file persisting the uuid/group -> display-name map |
|
| Where signal-cli writes attachments |
|
| Max image size bridged as base64 |
| (unset — off) | Append-only JSONL debug log |
Notes
Markdown bold/italic/strikethrough/code is converted to Signal text styles (BodyRange); headers, links and lists pass through as plain text.
Image attachments under
SIGNAL_ATTACH_MAX_BYTESare bridged as base64 image blocks; anything else becomes a text note.Author and group name are embedded in the message text, not just metadata, because hosts commonly render only the text — bare text would otherwise arrive anonymous.
Read receipts are sent for delivered messages.
License
This server cannot be deployed
Maintenance
Related MCP Connectors
The official Planning Center MCP server for interacting with your ministry's data.
MCP connector for iMessage & Contacts via a local Mac agent + Vercel relay
Telegram bridge for your MCP-compatible agent. Bidirectional, no LLM in our stack.
MCP server for Sendbird — chat users, channels, members, and messages from your AI client.
Related MCP Servers
- FlicenseNot gradedqualityFmaintenanceAn MCP integration for signal-cli that allows AI agents to send and receive Signal messages, supporting direct messages, group messages, and async message handling.26-
- AlicenseAqualityAmaintenanceLocal Signal MCP server: read via Signal Desktop, send via signal-cli8MIT
- MIT
- FlicenseNot gradedqualityCmaintenanceMCP server for Signal via signal-cli that enables sending and receiving messages, managing contacts and groups, and reacting over stdio.5 npm-