Install guide · Cursor
Install Signal Messaging (via signal-cli) for Cursor
Cursor reads ~/.cursor/mcp.json. A project can also commit .cursor/mcp.json.
Add to Cursor: Signal Messaging (via signal-cli)Install in VS Code: Signal Messaging (via signal-cli)Install in VS Code Insiders: Signal Messaging (via signal-cli)
Needs Cursor or VS Code installed on this device. The button opens the app and asks you to confirm before it adds the server.
Open ~/.cursor/mcp.json on macOS, %USERPROFILE%\.cursor\mcp.json on Windows, or ~/.cursor/mcp.json on Linux.
Paste the JSON config below.
Replace placeholder secrets, then restart the client if it does not reload on its own.
{ "mcpServers": { "joshuawowk-signal-mcp": { "command": "docker", "args": [ "run", "-i", "--rm", "ghcr.io/joshuawowk/signal-mcp:1.0.1" ], "env": { "SIGNAL_SENDER": "", "SIGNAL_DEFAULT_RECIPIENT": "", "SIGNAL_RPC_URL": "http://host.docker.internal:8080/api/v1/rpc", "SIGNAL_TCP_HOST": "127.0.0.1", "SIGNAL_TCP_PORT": "7583", "SIGNAL_INBOX_PATH": "/data/inbox.jsonl", "SIGNAL_POLL_INTERVAL": "3", "SIGNAL_INBOX_RETENTION_DAYS": "14" } } }}
Where the config lives
| System | Path |
|---|---|
| macOS | ~/.cursor/mcp.json |
| Windows | %USERPROFILE%\.cursor\mcp.json |
| Linux | ~/.cursor/mcp.json |