Add your description here
Project description
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
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file iflow_mcp_rymurr_signal_mcp-0.1.0.tar.gz.
File metadata
- Download URL: iflow_mcp_rymurr_signal_mcp-0.1.0.tar.gz
- Upload date:
- Size: 18.0 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.10.0 {"installer":{"name":"uv","version":"0.10.0","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
d71e2473260e7a660d2feddccbd9f2f29ad8628a86726b187ae611d59a42e6f8
|
|
| MD5 |
4c6586fe15d3ace94e38a5b918c40236
|
|
| BLAKE2b-256 |
12373ab9c7c6055d116eaf504e842941ea6f0e984b4a31c7dd0493d6d4a0207b
|
File details
Details for the file iflow_mcp_rymurr_signal_mcp-0.1.0-py3-none-any.whl.
File metadata
- Download URL: iflow_mcp_rymurr_signal_mcp-0.1.0-py3-none-any.whl
- Upload date:
- Size: 5.4 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.10.0 {"installer":{"name":"uv","version":"0.10.0","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
4bf1e37e4f82adb797f107a2985d512d40a6de09f4b6542e6eb1b165fcdd3066
|
|
| MD5 |
17aff3239b0d13f6bbc59d36a117d348
|
|
| BLAKE2b-256 |
374ce611e4d03536b649a8a0df0ad6bbbe98ebca32755e642e8ccbda5e635bbf
|
