Signal MCP

Integrations

  • Allows AI agents to send and receive Signal messages, supporting direct messages to users, messages to groups, and processing of incoming messages with async support and timeout handling.

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
-
security - not tested
F
license - not found
-
quality - not tested

An MCP integration for signal-cli that allows AI agents to send and receive Signal messages, supporting direct messages, group messages, and async message handling.

  1. Features
    1. Prerequisites
      1. Installing signal-cli
    2. Installation
      1. Usage
        1. API
          1. Tools Available
        2. Development
          ID: ulcycnemge