Prototipo · Versión preliminar: todos los servidores del registro oficial, sincronizados cada 30 minutos. Inicia sesión con Google para escribir reseñas.Prototipo · se actualiza cada 30 min
PopNx MCPServidores MCP para quienes usan IA · en palabras sencillas

Signal Messaging (via signal-cli)

de joshuawowkversión 1.0.1i★ 0iSe ejecuta en tu computadoraRepositorio ↗
Nombre en el registroio.github.joshuawowk/signal-mcp

Cómo instalar

What it does

Send Signal messages and read replies through your own signal-cli JSON-RPC daemon (unofficial).

  • Connects Se ejecuta en tu computadora
  • Account or key No key needed · 2 settings to fill in (SIGNAL_SENDER, SIGNAL_DEFAULT_RECIPIENT)
  • Category Herramientas para desarrolladores

Úsalo junto con

Skills que enseñan a la IA este tipo de trabajo; funcionan junto a este

rea

Reverse engineer anything with agents, from app behavior down to native binaries.

de morluto★ 468.7331 skills

Skill · Guía de trabajo

andrej-karpathy-skills

A single CLAUDE.md file to improve Claude Code behavior, derived from Andrej Karpathy's observations on LLM coding pitfalls.

de multica-ai★ 234.3321 skills

Skill · Guía de trabajoSin licencia indicada

graphify

Turn any codebase, with its docs, SQL schemas, configs, and PDFs, into a queryable knowledge graph. A /graphify skill for Claude Code, Cursor, Codex, and Gemini CLI: local deterministic AST parsing, every edge explained, no vector store.

de Graphify-Labs★ 150.2871 skills

Skill · Guía de trabajo

Por qué está en este puesto

Las listas se ordenan por una puntuación de uso (sobre 100) con estas partes

Popularidad0/80Estrellas de GitHub o descargas semanales: la mayor cuenta 60, la menor 20
Actualidad12/12Puntuación completa con una versión o cambio de código en 30 días
Sigue respondiendo0/8El endpoint en la nube respondió en la última revisión
Puntuación de uso12/100

Calidad: Pasó 3/3 revisiones básicas (se muestra, no ordena) · Impulso: Sin datos aún (Solo se usa en la pestaña En auge)

Instalación

Elige la app de IA que usas y copia la configuración.

Que tu IA lo instale con una frase

Instala Signal Messaging (via signal-cli). Sigue https://mcp.popnx.com/i/joshuawowk-signal-mcp.md, enséñame los comandos y espera mi OK antes de ejecutarlos.

Pégala en una IA que trabaje en tu equipo (como Claude Code o Cursor). Lee nuestros pasos, te muestra los comandos y espera tu OK. Sin clave ni registro. · Ver el texto completo que lee tu IA

Pasó 3/3 revisiones · Funciona en tu computadora · ✓ Comandos revisados el 14 nov 2026

Primero: ¿qué IA usas?

Elige tu app y los pasos aparecen abajo.

Funciona con Claude, pero hay que preparar algo antes

2 ajuste(s) que rellenar (SIGNAL_SENDER, SIGNAL_DEFAULT_RECIPIENT) · Instala Docker en tu computadora primero (una sola vez) · Solo en la app de Claude para computadora (Windows o Mac), no en la web ni en el móvil

Que la IA lo instale

Copia este mensaje en un chat de Claude. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.

Instala el MCP server Signal Messaging (via signal-cli) para Claude en este equipo, en este orden: 1) Comprueba Docker con docker --version. Si falta, dime que lo instale desde https://www.docker.com/products/docker-desktop/; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "mcpServers": { "signal": { "command": "docker", "args": [ "run", "-i", "--rm", "-e", "SIGNAL_SENDER", "-e", "SIGNAL_DEFAULT_RECIPIENT", "ghcr.io/joshuawowk/signal-mcp:1.0.1", "python3", "/app/server.py" ], "env": { "SIGNAL_SENDER": "your-value", "SIGNAL_DEFAULT_RECIPIENT": "your-value" } } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) En SIGNAL_SENDER, SIGNAL_DEFAULT_RECIPIENT deja "your-value" y dime que pegue yo el valor real en el archivo o en el campo de la app. Nunca me pidas escribir una clave en el chat. 5) Haz lo acordado y comprueba que las herramientas de Signal Messaging (via signal-cli) aparecen de verdad.

Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.

  1. Instala Docker (si no lo tienes)

    ¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter

    docker --version
    • Aparece un número de versión, p. ej. Docker version … = ya está instalado, sáltate este paso
    • Aparece "command not found" (en Windows, "is not recognized") = aún no está instalado, o acabas de instalarlo y debes cerrar y volver a abrir la Terminal
    Cómo abrir la Terminal

    Mac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter

    Windows: abre Inicio, escribe Windows PowerShell y elige Abrir

    Si no está instalado: Instala Docker Desktop: en Mac abre Docker.dmg y arrastra el icono a Aplicaciones (elige Apple silicon o Intel según tu Mac) · en Windows haz doble clic en Docker Desktop Installer.exe · luego abre la app Docker Desktop y déjala abierta. No necesitas ningún comando curl

    Abrir la página de descarga de Docker ↗

    Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: docker --version

    Se instala una vez y sirve para todo lo que usa Docker

  2. Rellena 2 ajuste(s)

    Son ajustes del programa, no claves. No hace falta registrarse; rellénalos como explica el autor.

    • SIGNAL_SENDER Número E.164 de la cuenta registrada en signal-cli (p. ej. +15555550100)
      Ver original en inglésE.164 number of the account registered in signal-cli (e.g. +15555550100)
    • SIGNAL_DEFAULT_RECIPIENT Número E.164 al que se envían mensajes por defecto; las herramientas aceptan un destinatario distinto en cada llamada.
      Ver original en inglésE.164 number messaged by default; tools accept a per-call recipient override

    Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.

  3. Abre el archivo de configuración de la app de Claude de escritorio

    SettingsDeveloperEdit Config

  4. Pega esta configuración y guarda el archivo

    {
      "mcpServers": {
        "signal": {
          "command": "docker",
          "args": [
            "run",
            "-i",
            "--rm",
            "-e",
            "SIGNAL_SENDER",
            "-e",
            "SIGNAL_DEFAULT_RECIPIENT",
            "ghcr.io/joshuawowk/signal-mcp:1.0.1",
            "python3",
            "/app/server.py"
          ],
          "env": {
            "SIGNAL_SENDER": "your-value",
            "SIGNAL_DEFAULT_RECIPIENT": "your-value"
          }
        }
      }
    }
  5. Cierra Claude y vuelve a abrirlo

  6. Pruébalo

    Usa Signal Messaging (via signal-cli) y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Claude dice que está usando Signal Messaging (via signal-cli) o muestra una herramienta de Signal Messaging (via signal-cli) en la respuesta, ya está conectado

6 ajuste(s) opcional(es) (funciona sin ellos)

El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.

  • SIGNAL_RPC_URL Endpoint HTTP JSON-RPC de signal-cli tal como se ve desde el contenedor. El valor predeterminado integrado del servidor es http://127.0.0.1:8080/api/v1/rpc (usar con --network host en Linux); esta lista usa por defecto el Docker…
    Ver original en ingléssignal-cli HTTP JSON-RPC endpoint as seen from the container. The server's built-in default is http://127.0.0.1:8080/api/v1/rpc (use with --network host on Linux); this listing defaults to the Docker…
    · valor por defecto http://host.docker.internal:8080/api/v1/rpc
  • SIGNAL_TCP_HOST Host TCP del daemon de signal-cli, utilizado solo para la comprobación de estado de la ruta de recepción.
    Ver original en ingléssignal-cli daemon TCP host, used only for the receive-path health check
    · valor por defecto 127.0.0.1
  • SIGNAL_TCP_PORT Puerto TCP del daemon de signal-cli (iniciado con --tcp), utilizado solo para la comprobación de estado de la ruta de recepción.
    Ver original en ingléssignal-cli daemon TCP port (daemon started with --tcp), used only for the receive-path health check
    · valor por defecto 7583
  • SIGNAL_INBOX_PATH Ruta del archivo de bandeja de respuestas dentro del contenedor (se llena solo con el proceso suscriptor).
    Ver original en inglésPath of the replies inbox file inside the container (populated only by the subscriber process)
    · valor por defecto /data/inbox.jsonl
  • SIGNAL_POLL_INTERVAL Frecuencia de sondeo de suscriptores en segundos
    Ver original en inglésSubscriber poll cadence in seconds
    · valor por defecto 3
  • SIGNAL_INBOX_RETENTION_DAYS Días de respuestas que se conservan en el archivo de la bandeja de entrada
    Ver original en inglésDays of replies kept in the inbox file
    · valor por defecto 14

Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.

Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión

ChatGPT todavía no puede conectar Signal Messaging (via signal-cli)

Signal Messaging (via signal-cli) se instala en tu computadora, pero ChatGPT solo conecta servidores que funcionan en la web

Lo que puedes hacer en su lugar

A · Usa una app que pueda conectar Signal Messaging (via signal-cli)

  • 2 ajuste(s) que rellenar (SIGNAL_SENDER, SIGNAL_DEFAULT_RECIPIENT) · Instala Docker en tu computadora primero (una sola vez) · Solo en la app de Claude para computadora (Windows o Mac), no en la web ni en el móvil
  • 2 ajuste(s) que rellenar (SIGNAL_SENDER, SIGNAL_DEFAULT_RECIPIENT) · Instala Docker en tu computadora primero (una sola vez)
  • 2 ajuste(s) que rellenar (SIGNAL_SENDER, SIGNAL_DEFAULT_RECIPIENT) · Instala Docker en tu computadora primero (una sola vez)
  • 2 ajuste(s) que rellenar (SIGNAL_SENDER, SIGNAL_DEFAULT_RECIPIENT) · Instala Docker en tu computadora primero (una sola vez)

B · Otros en Herramientas para desarrolladores que funcionan con ChatGPT

Elegidos entre los más usados de la misma categoría, solo los que se conectan con una dirección y sin clave

Funciona con Claude Code, pero hay que preparar algo antes

2 ajuste(s) que rellenar (SIGNAL_SENDER, SIGNAL_DEFAULT_RECIPIENT) · Instala Docker en tu computadora primero (una sola vez)

Que la IA lo instale

Copia este mensaje en un chat de Claude Code. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.

Instala el MCP server Signal Messaging (via signal-cli) para Claude Code en este equipo, en este orden: 1) Comprueba Docker con docker --version. Si falta, dime que lo instale desde https://www.docker.com/products/docker-desktop/; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): claude mcp add --scope user signal --env SIGNAL_SENDER=your-value --env SIGNAL_DEFAULT_RECIPIENT=your-value -- docker run -i --rm -e SIGNAL_SENDER -e SIGNAL_DEFAULT_RECIPIENT ghcr.io/joshuawowk/signal-mcp:1.0.1 python3 /app/server.py 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) En SIGNAL_SENDER, SIGNAL_DEFAULT_RECIPIENT deja "your-value" y dime que pegue yo el valor real en el archivo o en el campo de la app. Nunca me pidas escribir una clave en el chat. 5) Haz lo acordado y comprueba que las herramientas de Signal Messaging (via signal-cli) aparecen de verdad.

Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.

  1. Instala Docker (si no lo tienes)

    ¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter

    docker --version
    • Aparece un número de versión, p. ej. Docker version … = ya está instalado, sáltate este paso
    • Aparece "command not found" (en Windows, "is not recognized") = aún no está instalado, o acabas de instalarlo y debes cerrar y volver a abrir la Terminal
    Cómo abrir la Terminal

    Mac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter

    Windows: abre Inicio, escribe Windows PowerShell y elige Abrir

    Si no está instalado: Instala Docker Desktop: en Mac abre Docker.dmg y arrastra el icono a Aplicaciones (elige Apple silicon o Intel según tu Mac) · en Windows haz doble clic en Docker Desktop Installer.exe · luego abre la app Docker Desktop y déjala abierta. No necesitas ningún comando curl

    Abrir la página de descarga de Docker ↗

    Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: docker --version

    Se instala una vez y sirve para todo lo que usa Docker

  2. Rellena 2 ajuste(s)

    Son ajustes del programa, no claves. No hace falta registrarse; rellénalos como explica el autor.

    • SIGNAL_SENDER Número E.164 de la cuenta registrada en signal-cli (p. ej. +15555550100)
      Ver original en inglésE.164 number of the account registered in signal-cli (e.g. +15555550100)
    • SIGNAL_DEFAULT_RECIPIENT Número E.164 al que se envían mensajes por defecto; las herramientas aceptan un destinatario distinto en cada llamada.
      Ver original en inglésE.164 number messaged by default; tools accept a per-call recipient override

    Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.

  3. Abre la Terminal

    Mac: pulsa Command+Espacio y escribe Terminal · Windows: abre PowerShell

  4. Pega este comando y pulsa Enter

    claude mcp add --scope user signal --env SIGNAL_SENDER=your-value --env SIGNAL_DEFAULT_RECIPIENT=your-value -- docker run -i --rm -e SIGNAL_SENDER -e SIGNAL_DEFAULT_RECIPIENT ghcr.io/joshuawowk/signal-mcp:1.0.1 python3 /app/server.py
  5. Escribe /mcp en Claude Code

    Deberías ver Signal Messaging (via signal-cli) en la lista como conectado

  6. Pruébalo

    Usa Signal Messaging (via signal-cli) y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Claude Code dice que está usando Signal Messaging (via signal-cli) o muestra una herramienta de Signal Messaging (via signal-cli) en la respuesta, ya está conectado

6 ajuste(s) opcional(es) (funciona sin ellos)

El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.

  • SIGNAL_RPC_URL Endpoint HTTP JSON-RPC de signal-cli tal como se ve desde el contenedor. El valor predeterminado integrado del servidor es http://127.0.0.1:8080/api/v1/rpc (usar con --network host en Linux); esta lista usa por defecto el Docker…
    Ver original en ingléssignal-cli HTTP JSON-RPC endpoint as seen from the container. The server's built-in default is http://127.0.0.1:8080/api/v1/rpc (use with --network host on Linux); this listing defaults to the Docker…
    · valor por defecto http://host.docker.internal:8080/api/v1/rpc
  • SIGNAL_TCP_HOST Host TCP del daemon de signal-cli, utilizado solo para la comprobación de estado de la ruta de recepción.
    Ver original en ingléssignal-cli daemon TCP host, used only for the receive-path health check
    · valor por defecto 127.0.0.1
  • SIGNAL_TCP_PORT Puerto TCP del daemon de signal-cli (iniciado con --tcp), utilizado solo para la comprobación de estado de la ruta de recepción.
    Ver original en ingléssignal-cli daemon TCP port (daemon started with --tcp), used only for the receive-path health check
    · valor por defecto 7583
  • SIGNAL_INBOX_PATH Ruta del archivo de bandeja de respuestas dentro del contenedor (se llena solo con el proceso suscriptor).
    Ver original en inglésPath of the replies inbox file inside the container (populated only by the subscriber process)
    · valor por defecto /data/inbox.jsonl
  • SIGNAL_POLL_INTERVAL Frecuencia de sondeo de suscriptores en segundos
    Ver original en inglésSubscriber poll cadence in seconds
    · valor por defecto 3
  • SIGNAL_INBOX_RETENTION_DAYS Días de respuestas que se conservan en el archivo de la bandeja de entrada
    Ver original en inglésDays of replies kept in the inbox file
    · valor por defecto 14

Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.

Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Funciona con Cursor, pero hay que preparar algo antes

2 ajuste(s) que rellenar (SIGNAL_SENDER, SIGNAL_DEFAULT_RECIPIENT) · Instala Docker en tu computadora primero (una sola vez)

Que la IA lo instale

Copia este mensaje en un chat de Cursor. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.

Instala el MCP server Signal Messaging (via signal-cli) para Cursor en este equipo, en este orden: 1) Comprueba Docker con docker --version. Si falta, dime que lo instale desde https://www.docker.com/products/docker-desktop/; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "mcpServers": { "signal": { "command": "docker", "args": [ "run", "-i", "--rm", "-e", "SIGNAL_SENDER", "-e", "SIGNAL_DEFAULT_RECIPIENT", "ghcr.io/joshuawowk/signal-mcp:1.0.1", "python3", "/app/server.py" ], "env": { "SIGNAL_SENDER": "your-value", "SIGNAL_DEFAULT_RECIPIENT": "your-value" } } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) En SIGNAL_SENDER, SIGNAL_DEFAULT_RECIPIENT deja "your-value" y dime que pegue yo el valor real en el archivo o en el campo de la app. Nunca me pidas escribir una clave en el chat. 5) Haz lo acordado y comprueba que las herramientas de Signal Messaging (via signal-cli) aparecen de verdad.

Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.

  1. Instala Docker (si no lo tienes)

    ¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter

    docker --version
    • Aparece un número de versión, p. ej. Docker version … = ya está instalado, sáltate este paso
    • Aparece "command not found" (en Windows, "is not recognized") = aún no está instalado, o acabas de instalarlo y debes cerrar y volver a abrir la Terminal
    Cómo abrir la Terminal

    Mac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter

    Windows: abre Inicio, escribe Windows PowerShell y elige Abrir

    Si no está instalado: Instala Docker Desktop: en Mac abre Docker.dmg y arrastra el icono a Aplicaciones (elige Apple silicon o Intel según tu Mac) · en Windows haz doble clic en Docker Desktop Installer.exe · luego abre la app Docker Desktop y déjala abierta. No necesitas ningún comando curl

    Abrir la página de descarga de Docker ↗

    Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: docker --version

    Se instala una vez y sirve para todo lo que usa Docker

  2. Rellena 2 ajuste(s)

    Son ajustes del programa, no claves. No hace falta registrarse; rellénalos como explica el autor.

    • SIGNAL_SENDER Número E.164 de la cuenta registrada en signal-cli (p. ej. +15555550100)
      Ver original en inglésE.164 number of the account registered in signal-cli (e.g. +15555550100)
    • SIGNAL_DEFAULT_RECIPIENT Número E.164 al que se envían mensajes por defecto; las herramientas aceptan un destinatario distinto en cada llamada.
      Ver original en inglésE.164 number messaged by default; tools accept a per-call recipient override

    Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.

  3. Pulsa este botón para abrir Cursor

    Abrir en Cursor

    Cursor te pedirá confirmar; pulsa Install

  4. Escribe tu clave

    En la configuración de Signal Messaging (via signal-cli), SIGNAL_SENDER, SIGNAL_DEFAULT_RECIPIENT está vacío; añade tu clave y guarda

  5. Abre el chat de IA de Cursor en modo Agent

  6. Pruébalo

    Usa Signal Messaging (via signal-cli) y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Cursor dice que está usando Signal Messaging (via signal-cli) o muestra una herramienta de Signal Messaging (via signal-cli) en la respuesta, ya está conectado

6 ajuste(s) opcional(es) (funciona sin ellos)

El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.

  • SIGNAL_RPC_URL Endpoint HTTP JSON-RPC de signal-cli tal como se ve desde el contenedor. El valor predeterminado integrado del servidor es http://127.0.0.1:8080/api/v1/rpc (usar con --network host en Linux); esta lista usa por defecto el Docker…
    Ver original en ingléssignal-cli HTTP JSON-RPC endpoint as seen from the container. The server's built-in default is http://127.0.0.1:8080/api/v1/rpc (use with --network host on Linux); this listing defaults to the Docker…
    · valor por defecto http://host.docker.internal:8080/api/v1/rpc
  • SIGNAL_TCP_HOST Host TCP del daemon de signal-cli, utilizado solo para la comprobación de estado de la ruta de recepción.
    Ver original en ingléssignal-cli daemon TCP host, used only for the receive-path health check
    · valor por defecto 127.0.0.1
  • SIGNAL_TCP_PORT Puerto TCP del daemon de signal-cli (iniciado con --tcp), utilizado solo para la comprobación de estado de la ruta de recepción.
    Ver original en ingléssignal-cli daemon TCP port (daemon started with --tcp), used only for the receive-path health check
    · valor por defecto 7583
  • SIGNAL_INBOX_PATH Ruta del archivo de bandeja de respuestas dentro del contenedor (se llena solo con el proceso suscriptor).
    Ver original en inglésPath of the replies inbox file inside the container (populated only by the subscriber process)
    · valor por defecto /data/inbox.jsonl
  • SIGNAL_POLL_INTERVAL Frecuencia de sondeo de suscriptores en segundos
    Ver original en inglésSubscriber poll cadence in seconds
    · valor por defecto 3
  • SIGNAL_INBOX_RETENTION_DAYS Días de respuestas que se conservan en el archivo de la bandeja de entrada
    Ver original en inglésDays of replies kept in the inbox file
    · valor por defecto 14

Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.

Nombres de menú comprobados con la ayuda de Cursor el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Funciona con VS Code, pero hay que preparar algo antes

2 ajuste(s) que rellenar (SIGNAL_SENDER, SIGNAL_DEFAULT_RECIPIENT) · Instala Docker en tu computadora primero (una sola vez)

Que la IA lo instale

Copia este mensaje en un chat de VS Code. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.

Instala el MCP server Signal Messaging (via signal-cli) para VS Code en este equipo, en este orden: 1) Comprueba Docker con docker --version. Si falta, dime que lo instale desde https://www.docker.com/products/docker-desktop/; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "servers": { "signal": { "type": "stdio", "command": "docker", "args": [ "run", "-i", "--rm", "-e", "SIGNAL_SENDER", "-e", "SIGNAL_DEFAULT_RECIPIENT", "ghcr.io/joshuawowk/signal-mcp:1.0.1", "python3", "/app/server.py" ], "env": { "SIGNAL_SENDER": "your-value", "SIGNAL_DEFAULT_RECIPIENT": "your-value" } } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) En SIGNAL_SENDER, SIGNAL_DEFAULT_RECIPIENT deja "your-value" y dime que pegue yo el valor real en el archivo o en el campo de la app. Nunca me pidas escribir una clave en el chat. 5) Haz lo acordado y comprueba que las herramientas de Signal Messaging (via signal-cli) aparecen de verdad.

Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.

  1. Instala Docker (si no lo tienes)

    ¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter

    docker --version
    • Aparece un número de versión, p. ej. Docker version … = ya está instalado, sáltate este paso
    • Aparece "command not found" (en Windows, "is not recognized") = aún no está instalado, o acabas de instalarlo y debes cerrar y volver a abrir la Terminal
    Cómo abrir la Terminal

    Mac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter

    Windows: abre Inicio, escribe Windows PowerShell y elige Abrir

    Si no está instalado: Instala Docker Desktop: en Mac abre Docker.dmg y arrastra el icono a Aplicaciones (elige Apple silicon o Intel según tu Mac) · en Windows haz doble clic en Docker Desktop Installer.exe · luego abre la app Docker Desktop y déjala abierta. No necesitas ningún comando curl

    Abrir la página de descarga de Docker ↗

    Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: docker --version

    Se instala una vez y sirve para todo lo que usa Docker

  2. Rellena 2 ajuste(s)

    Son ajustes del programa, no claves. No hace falta registrarse; rellénalos como explica el autor.

    • SIGNAL_SENDER Número E.164 de la cuenta registrada en signal-cli (p. ej. +15555550100)
      Ver original en inglésE.164 number of the account registered in signal-cli (e.g. +15555550100)
    • SIGNAL_DEFAULT_RECIPIENT Número E.164 al que se envían mensajes por defecto; las herramientas aceptan un destinatario distinto en cada llamada.
      Ver original en inglésE.164 number messaged by default; tools accept a per-call recipient override

    Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.

  3. Pulsa este botón para abrir VS Code

    Abrir en VS Code

    VS Code te pedirá confirmar; pulsa Install

  4. Escribe tu clave

    En la configuración de Signal Messaging (via signal-cli), SIGNAL_SENDER, SIGNAL_DEFAULT_RECIPIENT está vacío; añade tu clave y guarda

  5. Abre el chat de IA de VS Code en modo Agent

  6. Pruébalo

    Usa Signal Messaging (via signal-cli) y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si VS Code dice que está usando Signal Messaging (via signal-cli) o muestra una herramienta de Signal Messaging (via signal-cli) en la respuesta, ya está conectado

6 ajuste(s) opcional(es) (funciona sin ellos)

El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.

  • SIGNAL_RPC_URL Endpoint HTTP JSON-RPC de signal-cli tal como se ve desde el contenedor. El valor predeterminado integrado del servidor es http://127.0.0.1:8080/api/v1/rpc (usar con --network host en Linux); esta lista usa por defecto el Docker…
    Ver original en ingléssignal-cli HTTP JSON-RPC endpoint as seen from the container. The server's built-in default is http://127.0.0.1:8080/api/v1/rpc (use with --network host on Linux); this listing defaults to the Docker…
    · valor por defecto http://host.docker.internal:8080/api/v1/rpc
  • SIGNAL_TCP_HOST Host TCP del daemon de signal-cli, utilizado solo para la comprobación de estado de la ruta de recepción.
    Ver original en ingléssignal-cli daemon TCP host, used only for the receive-path health check
    · valor por defecto 127.0.0.1
  • SIGNAL_TCP_PORT Puerto TCP del daemon de signal-cli (iniciado con --tcp), utilizado solo para la comprobación de estado de la ruta de recepción.
    Ver original en ingléssignal-cli daemon TCP port (daemon started with --tcp), used only for the receive-path health check
    · valor por defecto 7583
  • SIGNAL_INBOX_PATH Ruta del archivo de bandeja de respuestas dentro del contenedor (se llena solo con el proceso suscriptor).
    Ver original en inglésPath of the replies inbox file inside the container (populated only by the subscriber process)
    · valor por defecto /data/inbox.jsonl
  • SIGNAL_POLL_INTERVAL Frecuencia de sondeo de suscriptores en segundos
    Ver original en inglésSubscriber poll cadence in seconds
    · valor por defecto 3
  • SIGNAL_INBOX_RETENTION_DAYS Días de respuestas que se conservan en el archivo de la bandeja de entrada
    Ver original en inglésDays of replies kept in the inbox file
    · valor por defecto 14

Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.

Nombres de menú comprobados con la ayuda de VS Code el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Otras apps que usan MCP, como Windsurf, Zed o Gemini CLI, añaden servidores de forma distinta. Míralo en la lista de apps

Ver todas las apps que usan MCP →

La configuración JSON está en “Para desarrolladores”, abajo

¿Te atascaste? Pregunta a quien usa Signal Messaging (via signal-cli)💬 Conversación →
Para desarrolladores: comandos de Terminal y configuración JSON

Instalado en tu computadora

Claude Code

claude mcp add --scope user signal --env SIGNAL_SENDER=your-value --env SIGNAL_DEFAULT_RECIPIENT=your-value -- docker run -i --rm -e SIGNAL_SENDER -e SIGNAL_DEFAULT_RECIPIENT ghcr.io/joshuawowk/signal-mcp:1.0.1 python3 /app/server.py

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "signal": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "SIGNAL_SENDER",
        "-e",
        "SIGNAL_DEFAULT_RECIPIENT",
        "ghcr.io/joshuawowk/signal-mcp:1.0.1",
        "python3",
        "/app/server.py"
      ],
      "env": {
        "SIGNAL_SENDER": "your-value",
        "SIGNAL_DEFAULT_RECIPIENT": "your-value"
      }
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "signal": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "SIGNAL_SENDER",
        "-e",
        "SIGNAL_DEFAULT_RECIPIENT",
        "ghcr.io/joshuawowk/signal-mcp:1.0.1",
        "python3",
        "/app/server.py"
      ],
      "env": {
        "SIGNAL_SENDER": "your-value",
        "SIGNAL_DEFAULT_RECIPIENT": "your-value"
      }
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "signal": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "SIGNAL_SENDER",
        "-e",
        "SIGNAL_DEFAULT_RECIPIENT",
        "ghcr.io/joshuawowk/signal-mcp:1.0.1",
        "python3",
        "/app/server.py"
      ],
      "env": {
        "SIGNAL_SENDER": "your-value",
        "SIGNAL_DEFAULT_RECIPIENT": "your-value"
      }
    }
  }
}

Valores que debes completar

  • SIGNAL_SENDER obligatorio env
    Número E.164 de la cuenta registrada en signal-cli (p. ej. +15555550100)
    Ver original en inglésE.164 number of the account registered in signal-cli (e.g. +15555550100)
  • SIGNAL_DEFAULT_RECIPIENT obligatorio env
    Número E.164 al que se envían mensajes por defecto; las herramientas aceptan un destinatario distinto en cada llamada.
    Ver original en inglésE.164 number messaged by default; tools accept a per-call recipient override
  • SIGNAL_RPC_URL env
    Endpoint HTTP JSON-RPC de signal-cli tal como se ve desde el contenedor. El valor predeterminado integrado del servidor es http://127.0.0.1:8080/api/v1/rpc (usar con --network host en Linux); esta lista usa por defecto el Docker…
    Ver original en ingléssignal-cli HTTP JSON-RPC endpoint as seen from the container. The server's built-in default is http://127.0.0.1:8080/api/v1/rpc (use with --network host on Linux); this listing defaults to the Docker…
  • SIGNAL_TCP_HOST env
    Host TCP del daemon de signal-cli, utilizado solo para la comprobación de estado de la ruta de recepción.
    Ver original en ingléssignal-cli daemon TCP host, used only for the receive-path health check
  • SIGNAL_TCP_PORT env
    Puerto TCP del daemon de signal-cli (iniciado con --tcp), utilizado solo para la comprobación de estado de la ruta de recepción.
    Ver original en ingléssignal-cli daemon TCP port (daemon started with --tcp), used only for the receive-path health check
  • SIGNAL_INBOX_PATH env
    Ruta del archivo de bandeja de respuestas dentro del contenedor (se llena solo con el proceso suscriptor).
    Ver original en inglésPath of the replies inbox file inside the container (populated only by the subscriber process)
  • SIGNAL_POLL_INTERVAL env
    Frecuencia de sondeo de suscriptores en segundos
    Ver original en inglésSubscriber poll cadence in seconds
  • SIGNAL_INBOX_RETENTION_DAYS env
    Días de respuestas que se conservan en el archivo de la bandeja de entrada
    Ver original en inglésDays of replies kept in the inbox file

Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.

Esta configuración se genera a partir de la ficha del creador en el registro. Si el README dice otra cosa, sigue el README.

De un vistazo

Descargas por semanai
No está en npm/PyPI
Conexión
Se ejecuta en tu computadora
Última versióni
1.0.1
Publicado en el registroi
21 oct 2026
Último cambio de códigoi
21 oct 2026
Creador
joshuawowk
Paquetes
oci: ghcr.io/joshuawowk/signal-mcp:1.0.1
Estado en el registro
Activo

Qué apps pueden usarlo

Según cómo se conecta este servidor y la documentación de cada app, comprobado el 10 nov 2026.

Se ejecutan en tu computadora en

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

Todas las apps, con ventajas y desventajas →

Qué puede hacer

Se ejecuta en tu computadora; la lista de herramientas aparece en tu app de IA después de instalarlo.

Revisiones básicasi

Revisamos información que cualquiera puede ver; no hemos leído el código. Las revisiones que no aplican no se cuentan. · Revisado el 20 nov 2026

  • ✓ Superada

    El creador coincide con el repo

    El nombre en el registro se verificó con la cuenta de GitHub joshuawowk, dueña del repo

  • ✓ Superada

    Sigue en mantenimiento

    Último cambio de código: hace 30 días

  • ✓ Superada

    Tiene licencia

    Usa MIT

  • – No aplica

    El endpoint responde

    Este se ejecuta en tu computadora; no hay endpoint en internet

  • – No aplica

    Inicio de sesión con OAuth

    Se ejecuta en tu computadora y usa ajustes locales en su lugar

  • … Aún sin revisar

    Sin instrucciones ocultas en las descripciones de herramientas

    Se ejecuta en tu computadora; solo podemos leer listas de herramientas de endpoints en internet

Vulnerabilidades publicadas (OSV.dev)

No revisado: solo se pueden revisar paquetes npm y PyPI con versión

Qué revisamos → · JSON

Creadores: pedir otra revisión o avisar de un dato erróneo
Para autores: añade una insignia a tu README

Si lo creaste tú, pega este código en tu README. La insignia enlaza a esta página.

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/joshuawowk-signal-mcp.svg)](https://mcp.popnx.com/en/servers/joshuawowk-signal-mcp)

Conversación

Pregunta, comparte un consejo o avisa de que no funciona. Ordenado por lo que la gente marcó como útil.

Aún no hay publicaciones. Sé la primera persona en preguntar o compartir.

Lo publicado aquí lo escriben usuarios, no el equipo de PopNx.

Inicia sesión para publicar

Reseñas de usuarios

Aún no hay reseñas

Inicia sesión para escribir una reseña

Comparado con otros en Herramientas para desarrolladoresi

  • Más estrellas que el 0% de los otros 6202 servidores de esta categoría
  • Publicado en el registro más recientemente que el 51% de los otros 6202 servidores de esta categoría
  • Revisiones básicas iguales o mejores que el 99% de los otros 6202 servidores de esta categoría

Comparado con todos los servidores activos de esta categoría en el registro. Las estrellas solo cuentan cuando quien lo publica es dueño del repo.

Preguntas frecuentes

¿Es seguro Signal Messaging (via signal-cli)?

Superó 3 de 3 revisiones básicas aplicables. No hemos leído el código. Antes de agregar una clave o un token, revisa qué acceso pide el servidor y usa una clave que tenga solo los permisos que necesitas.

¿Qué claves o códigos necesita?

El registro no indica ninguna clave obligatoria, aunque algunos servidores te piden iniciar sesión la primera vez que los usas.

¿Se ejecuta en mi computadora o en la nube?

Se ejecuta en tu computadora. Tu app de IA lo inicia cuando hace falta, y los datos no pasan por los servidores del creador (a menos que el propio servidor llame a un servicio en línea).

¿Sigue en mantenimiento?

El repo de GitHub cambió por última vez hace 30 días, y la última versión (1.0.1) llegó al registro hace 30 días.

¿Qué apps pueden usarlo?

Las apps compatibles con MCP, como Claude Desktop, Claude Code, Cursor y VS Code. También necesitas Docker en tu computadora.

¿Qué puedo usar en su lugar?

En la misma categoría: GitDiagram, Appllama, Cloudflare MCP, Omnara, Repowise

Alternativas parecidas

Misma categoría, otros creadores, comandos ya revisados. Primero los oficiales, luego por estrellas.

Cómo leer una tarjeta:↓ Descargas por semanai★ Estrellas de GitHubiTres pilares: reseñas · revisiones · usoiActualizado = fecha en que se publicó la última versión en el registroi

GitDiagram

Architecture diagrams, explanations and Mermaid source for public GitHub repositories.

de ahmedkhaleel2004Muy usado★ 19 milActualizado hace 2 meses

Se ejecuta en la nube✓ del servicio · gitdiagram.comProbado por el equipo de PopNx

Appllama

Study screens, flows and paywalls from top-earning iOS apps, then build from what wins.

de AppllamaMuy usado★ 5,2 milActualizado hace 3 meses

Se ejecuta en la nube✓ del servicio · appllama.io

Cloudflare MCP

Cloudflare MCP servers

de cloudflareMuy usado★ 4,5 milActualizado hace 14 meses

Se ejecuta en la nube✓ del servicio · mcp.cloudflare.comProbado por el equipo de PopNx

Omnara

Deploy durable AI agents with Omnara, an open-source managed-agent platform.

de omnara-aiMuy usado★ 3,4 milActualizado hace 2 meses

Se ejecuta en la nube✓ del servicio · omnara.com

Repowise

Codebase intelligence for AI coding agents: graph, git history, docs, decisions, code health.

de repowise-devMuy usado↓ 6,5 mil/sem★ 8,2 mil Estrellas de todo el repositorioActualizado hace 7 días

Computadora o nube✓ del servicio · repowise.dev
Comparado con otros parecidos
Este
Signal Messaging (via signal-cli)
GitDiagramAppllamaCloudflare MCPOmnaraRepowise
Dónde se ejecutaSe instala en tu equipoFunciona en la nube, sin instalar nadaFunciona en la nube, sin instalar nadaFunciona en la nube, sin instalar nadaFunciona en la nube, sin instalar nadaEn la nube o instalado en tu equipo
Necesita claveNoNoNoNoNoNo
Se añade con + en ClaudeNoNoNoSíNoNo
Revisiones básicas3/34/44/44/44/45/5
LicenciaMITMITMITApache-2.0Apache-2.0AGPL-3.0
PrecioSin coste en el registroSin coste en el registroSin coste en el registroSin coste en el registroSin coste en el registroSin coste en el registro

README del creador

Abrir el README

Copiado tal cual del repo del creador. PopNx MCP no lo ha revisado ni lo respalda. Se quitaron HTML, imágenes y scripts. Los enlaces llevan fuera de este sitio.

signal-mcp

An unofficial MCP integration for Signal via signal-cli. It lets an MCP client send you Signal messages (task-done pings, blocking questions, permission requests) and read your replies.

Requirements: a running signal-cli JSON-RPC daemon (signal-cli daemon --http ..., plus --tcp ... if you want replies) and a Signal phone number already registered with signal-cli. This project does not register numbers, run the daemon, or talk to Signal's servers itself; it is only a client of your daemon. It is not affiliated with or endorsed by Signal Messenger or the Signal Foundation.

It consists of an MCP server (app/server.py) and an optional reply subscriber (app/subscriber.py) that fronts the existing signal-cli daemon without re-registering or bind-mounting its data directory.

Install

The image is published at ghcr.io/joshuawowk/signal-mcp and listed in the MCP Registry as io.github.joshuawowk/signal-mcp. Run with no arguments, the container starts the reply subscriber (the long-running mode used by the Compose deployment below); the MCP server is started explicitly.

MCP client over stdio (send-only)
docker run -i --rm \

--add-host host.docker.internal:host-gateway \ -e SIGNAL_SENDER=+15555550100 \ -e SIGNAL_DEFAULT_RECIPIENT=+15555550101 \ -e SIGNAL_RPC_URL=http://host.docker.internal:8080/api/v1/rpc \ ghcr.io/joshuawowk/signal-mcp:latest python3 /app/server.py --stdio

Notes:

  • On Linux you can instead use --network host and drop the --add-host and SIGNAL_RPC_URL settings (the default 127.0.0.1:8080 then reaches your daemon).
  • With a bridge network the daemon must be reachable from the container. A daemon bound only to 127.0.0.1 is not. The signal-cli HTTP endpoint is unauthenticated: do not expose it beyond a trusted interface.
  • A standalone stdio container has no subscriber, so replies are not collected: signal_check_replies returns nothing and signal_health reports the receive path as down. For replies, use the Compose deployment below.
Compose deployment (send and receive replies)

See Setup.

Architecture

MCP client ──stdio──> docker exec ──> python3 /app/server.py ─┐

│ HTTP JSON-RPC host: signal-cli-daemon.service ◀── 127.0.0.1:8080 (synchronous)─┤ (send, version) ◀── 127.0.0.1:7583 (TCP stream)─┤ (receive notifications) │ docker container (signal-mcp, restart=unless-stopped) │ PID 1: subscriber.py ── persistent TCP socket ─────────────┘ └─> append /data/inbox.jsonl ◀── signal_check_replies reads

  • No bind-mount of signal-cli data. The container is purely a client of the host daemon. Signal identity keys never enter the container.
  • No re-registration. The Signal identity stays on the host.
  • Two-channel daemon. Synchronous calls (send, version, health) go over HTTP on :8080. Incoming-message notifications stream over a persistent TCP socket on :7583. The HTTP daemon's receive method is permanently locked by signal-cli's internal auto-receive loop, so TCP is the only path that works for replies.
  • One daemon flag added. The --tcp 127.0.0.1:7583 arg was added to the existing signal-cli-daemon.service ExecStart (see "Daemon configuration" below). HTTP behavior for any other consumer is unchanged.

Setup

git clone https://github.com/joshuawowk/signal-mcp && cd signal-mcp

cp .env.example .env # set SIGNAL_SENDER and SIGNAL_DEFAULT_RECIPIENT docker compose build docker compose up -d docker compose logs -f signal-mcp # watch the subscriber start up

Verify the daemon is reachable from the container:

docker exec signal-mcp python3 -c \

"import rpc; print(rpc.ping())"

expected: 0.14.3

Register the MCP server with Claude Desktop

Merge claude_desktop_config.snippet.json into ~/.config/Claude/claude_desktop_config.json under mcpServers:

"signal": {

"command": "sg", "args": ["docker", "-c", "exec docker exec -i signal-mcp python3 /app/server.py"] }

Restart Claude Desktop.

Why the sg wrapper

sg docker -c "…" runs the command under the docker supplementary group. This is required when the Claude Desktop process was started before your user was added to the docker group — existing sessions inherit a stale supplementary-group list and docker exec returns permission denied while trying to connect to the docker API at unix:///var/run/docker.sock, which surfaces in Claude Desktop's logs as write EPIPE / Server transport closed unexpectedly.

The exec inside the -c string replaces the temporary bash spawned by sg with the docker exec process, so SIGTERM/SIGPIPE from Claude Desktop reach the MCP server cleanly when the connection closes.

If you log out + back in (or reboot), all new processes inherit the docker group and the wrapper isn't strictly needed — but it's harmless to keep, and it makes the config portable across hosts where the group situation may vary. The signal server will appear in the MCP server list and its tools (signal_send_message, signal_send_question, signal_send_permission_request, signal_check_replies, signal_health) become available to any session.

Install the companion skill

An example agent skill lives in skill/SKILL.md (written for one person's setup; adapt the name and wording). Copy or symlink it into your agent's skills directory, for example:

mkdir -p <your-skills-dir>/signal

ln -sf "$PWD/skill/SKILL.md" /signal/SKILL.md

End-to-end test from a Claude session

Use signal_health to confirm the daemon is up, then signal_send_message

with text="signal-mcp end-to-end test from session XYZ" and session_id="signal-mcp-test-001". Then wait 30 seconds and call signal_check_replies with session_id="signal-mcp-test-001".

Reply with anything from your phone; the next signal_check_replies call should return your message.

Tools

ToolWhen to call
signal_send_message(text, recipient?, session_id?)Task-done pings, FYI updates. No reply expected.
signal_send_question(question, options?, recipient?, session_id?)Blocked, need an answer. options accepts a list ["A","B"], a JSON-array string '["A","B"]', or newline/comma-separated text — all normalized server-side. Response echoes options_parsed.
signal_send_permission_request(action, context, recipient?, session_id?)About to do something irreversible. Wait for explicit YES.
signal_check_replies(since?, from_recipient?, session_id?, limit?)Poll for replies. Filter by session_id.
signal_health()Full health: send path (daemon HTTP), receive path (TCP port + subscriber process liveness), and inbox status. ok is true only when send AND receive are healthy. An empty inbox is normal. Run first if anything fails.
Reliability notes (Jun 2026)
  • The inbox file (/data/inbox.jsonl) is created at subscriber startup and is never deleted by retention pruning — an empty inbox stays as a 0-byte file. Previously, pruning removed the file entirely once all records aged out (14-day retention), which made signal_check_replies / signal_health look like the subscriber was down. signal_check_replies and signal_health also ensure the file exists on every call.
  • signal_health and signal_check_replies report subscriber_running (scans /proc for subscriber.py) and receive_channel_ok (TCP connect to the daemon's :7583), so a fresh session can distinguish "no replies yet" from "receive path broken".
  • signal_send_question tolerates clients that serialize the options list into a string (see tools table).

Config (.env)

VariableMeaning
SIGNAL_SENDERE.164 of the registered signal-cli account. Required.
SIGNAL_DEFAULT_RECIPIENTE.164 to ping by default. Required.
SIGNAL_RPC_URLDaemon endpoint as seen from the container. Default http://127.0.0.1:8080/api/v1/rpc; with network_mode: host, that works.
SIGNAL_TCP_HOST / SIGNAL_TCP_PORTDaemon TCP stream for receive notifications. Defaults 127.0.0.1 / 7583.
SIGNAL_POLL_INTERVALSubscriber poll cadence in seconds.
SIGNAL_INBOX_RETENTION_DAYSDays of replies kept in inbox.jsonl.
SIGNAL_INBOX_PATHInbox file path inside the container.

Operational

docker compose ps                       # status

docker compose logs -f signal-mcp # subscriber output docker exec signal-mcp tail -f /data/inbox.jsonl # raw replies docker compose restart signal-mcp # bounce the container docker compose down # stop

If the host daemon is restarted, the subscriber will reconnect on its next poll (errors back off up to 60 s).

Notes & limitations

  • Linux host only. network_mode: host is a no-op on Docker Desktop for macOS/Windows. To move it: switch to a bridge network, set SIGNAL_RPC_URL=http://host.docker.internal:8080/api/v1/rpc, and add extra_hosts: ["host.docker.internal:host-gateway"].
  • HTTP daemon polling. signal-cli's HTTP mode does not stream receive events; we poll. A TCP-mode daemon with WebSocket subscription would be lower-latency, but would require changing your existing daemon service.
  • Attachments are skipped. The subscriber only persists text bodies. Reactions, typing indicators, and read receipts are ignored.
  • The phone number is not memorized. It lives only in .env and the registration snippet, both inside this project.

Daemon configuration

This project requires the host's signal-cli-daemon.service to expose both HTTP (for synchronous calls) and TCP (for streaming receive notifications). The unit file at ~/.config/systemd/user/signal-cli-daemon.service should have:

ExecStart=/usr/local/bin/signal-cli -a +15555550100 daemon --http 127.0.0.1:8080 --tcp 127.0.0.1:7583 --receive-mode on-start

To apply changes:

systemctl --user daemon-reload

systemctl --user restart signal-cli-daemon.service

A backup of the original unit file is written next to the live one with a .bak.YYYYMMDD-HHMMSS suffix the first time signal-mcp is set up.

Why not just use HTTP for receive?

signal-cli's HTTP daemon mode is synchronous-only. receive over HTTP always errors with "Receive command cannot be used if messages are already being received" because the daemon's internal receive loop owns the queue and HTTP has no way to deliver push events. TCP mode opens a persistent newline-delimited JSON-RPC stream and pushes receive notifications as they arrive — that's the path subscriber.py uses.