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

Related MCP server: signal-mcp

Prerequisites

This project requires signal-cli to be installed and configured on your system.

Installing signal-cli

1. Install signal-cli: Follow the official installation instructions

2. Register your Signal account:

   signal-cli -u YOUR_PHONE_NUMBER register

3. 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 user

• send_message_to_group: Send a message to a Signal group

• receive_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