# RelayMCP

RelayMCP links your personal WhatsApp to an AI coding assistant so it can retrieve chat details, schedule reminders, and prepare replies to contacts.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: relaymcp
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/relaymcp/relaymcp
- Updated: 2026-10-12
- HTML: https://affpapa.org/en/nevibecode/mcp/relaymcp

## What it does

RelayMCP connects a personal WhatsApp account to AI clients through the Model Context Protocol. An agent can look up contacts and messages, retrieve conversation context, summarize discussions, and draft replies. It can also create reminders and schedule follow-ups. Voice notes can be transcribed, while incoming images and documents can be inspected by the assistant.

To connect, scan the QR code in WhatsApp's Linked devices section, then register your individual RelayMCP endpoint as a remote MCP server. Communication uses Streamable HTTP, with OAuth 2.1 or bearer API-key authentication. The server exposes tools for chat and contact lookup, message handling, media access, and reminders. Existing chat history is not imported during linking.

Privacy controls let you block specific chats. Their incoming messages are discarded rather than stored or exposed to the AI, and previously retained data for those chats is erased. Messages are automatically deleted after 72 hours unless you adjust retention. Outgoing messages are sent individually, with a quiet period from 9 PM to 9 AM in the recipient's local time. RelayMCP is currently running an invite-only private pilot.

## Requirements
- Remote server: `https://{user}-mcp.relaymcp.app/mcp`

## Install

### Claude Code (native platform)

1. **Template address**
- The server address is a template: replace {…} or […] with your own values

2. **Platform CLI: remote server**
```bash
claude mcp add --transport http whatsapp https://{user}-mcp.relaymcp.app/mcp
```

### Codex

1. **Template address**
- The server address is a template: replace {…} or […] with your own values

2. **Platform CLI: remote server**
```bash
codex mcp add relaymcp --url https://{user}-mcp.relaymcp.app/mcp
```

### Cursor

1. **Template address**
- The server address is a template: replace {…} or […] with your own values

2. **Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "relaymcp": {
            "url": "https://{user}-mcp.relaymcp.app/mcp"
        }
    }
}
```

### GitHub Copilot

1. **Template address**
- The server address is a template: replace {…} or […] with your own values

2. **Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "relaymcp": {
            "type": "http",
            "url": "https://{user}-mcp.relaymcp.app/mcp"
        }
    }
}
```

### Gemini CLI

1. **Template address**
- The server address is a template: replace {…} or […] with your own values

2. **Platform CLI: remote server**
```bash
gemini mcp add -t http relaymcp https://{user}-mcp.relaymcp.app/mcp
```

## When to use it
- Retrieve a meeting time mentioned in a WhatsApp conversation
- Summarize chat decisions and outstanding questions
- Schedule a reminder to call a contact
- Prepare a follow-up when a supplier misses a confirmation deadline
- Transcribe a WhatsApp voice note

## Example prompts
- Find the time Priya mentioned for our meeting in WhatsApp.
- Remind me tomorrow at 10 to call Rahul.
- If the supplier has not confirmed by Friday, draft a follow-up message.

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 392262
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33989
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81163
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119231
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47577
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43902

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md