Signal Mcp
What is Signal Mcp
signal-mcp is an integration for signal-cli that enables AI agents to send and receive messages through the Signal messaging platform.
Use cases
Use cases include automating responses to customer inquiries, sending notifications to groups, and integrating Signal messaging into AI-driven applications.
How to use
To use signal-mcp, install signal-cli, register your Signal account, and then run the MCP server using your phone number as the user ID.
Key features
Key features include sending messages to individual Signal users and groups, receiving and parsing incoming messages, asynchronous support with timeout handling, and detailed logging.
Where to use
signal-mcp can be used in various fields such as customer support, automated messaging systems, and any application requiring secure messaging through Signal.
Clients Supporting MCP
The following are the main client software that supports the Model Context Protocol. Click the link to visit the official website for more information.
Overview
What is Signal Mcp
signal-mcp is an integration for signal-cli that enables AI agents to send and receive messages through the Signal messaging platform.
Use cases
Use cases include automating responses to customer inquiries, sending notifications to groups, and integrating Signal messaging into AI-driven applications.
How to use
To use signal-mcp, install signal-cli, register your Signal account, and then run the MCP server using your phone number as the user ID.
Key features
Key features include sending messages to individual Signal users and groups, receiving and parsing incoming messages, asynchronous support with timeout handling, and detailed logging.
Where to use
signal-mcp can be used in various fields such as customer support, automated messaging systems, and any application requiring secure messaging through Signal.
Clients Supporting MCP
The following are the main client software that supports the Model Context Protocol. Click the link to visit the official website for more information.
Content
Signal MCP
An MCP integration for signal-cli that allows AI agents to send and receive Signal messages.
Features
- Send messages to Signal users
- Send messages to Signal groups
- Receive and parse incoming messages
- Async support with timeout handling
- Detailed logging
Prerequisites
This project requires signal-cli to be installed and configured on your system.
Installing signal-cli
-
Install signal-cli: Follow the official installation instructions
-
Register your Signal account:
signal-cli -u YOUR_PHONE_NUMBER register -
Verify your account with the code received via SMS:
signal-cli -u YOUR_PHONE_NUMBER verify CODE_RECEIVED
For more detailed setup instructions, see the signal-cli documentation.
Installation
pip install -e .
# or use uv for faster installation
uv pip install -e .
Usage
Run the MCP server:
./main.py --user-id YOUR_PHONE_NUMBER [--transport {sse|stdio}]
API
Tools Available
send_message_to_user: Send a direct message to a Signal usersend_message_to_group: Send a message to a Signal groupreceive_message: Wait for and receive messages with timeout support
Development
This project uses:
- MCP for agent-API integration
- Modern Python async patterns
- Type annotations throughout
Dev Tools Supporting MCP
The following are the main code editors that support the Model Context Protocol. Click the link to visit the official website for more information.
