Signal

GitHub
Integrates with
signal-cli

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

  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