# Parley

The Parley MCP server for Claude Code connects an agent to WhatsApp. It reads chats and sends messages from a linked number.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 5 repo stars
- Author: Verbiflow
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/Verbiflow/parley
- Updated: 2026-11-06
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/parley

## What it does

Parley gives an agent access to WhatsApp conversations, so it can read chats, reply, react, and message from a linked number. Outgoing messages enter a queue and are sent with pauses, within daily caps and active hours when those are enabled for the number. New accounts start with low caps.

The server also passes incoming media to the agent and supports photos, video, voice notes, and documents. Its dashboard shows delivery and read status; queued messages can be cancelled, and an agent’s access can be cut off there. Linking requires signing in to the service and scanning a WhatsApp QR code with a phone. The phone remains usable during this process. The MCP tools are in early development and may change.

## Requirements
- Remote server: `https://app.itsparley.com/mcp`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http parley https://app.itsparley.com/mcp
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add parley --url https://app.itsparley.com/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "parley": {
            "url": "https://app.itsparley.com/mcp"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "parley": {
            "type": "http",
            "url": "https://app.itsparley.com/mcp"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http parley https://app.itsparley.com/mcp
```

## When to use it
- read WhatsApp conversations through an agent
- send a message from a linked number
- react to a chat message
- check whether a message was delivered or read
- retrieve incoming media for an agent

## Example prompts
- Read the latest messages in my chat with Maya.
- Message Maya to ask whether Thursday at three works for her.
- Show the sending queue and the message status.

## Similar
- [Context7](https://affpapa.org/en/nevibecode/mcp/context7.md) — MCP server · 5563 installs
- [Search Google Flights](https://affpapa.org/en/nevibecode/mcp/search-google-flights.md) — MCP server · 2595 installs
- [Math-MCP](https://affpapa.org/en/nevibecode/mcp/math-mcp.md) — MCP server · 5958 installs
- [pipeworx gateway](https://affpapa.org/en/nevibecode/mcp/pipeworx-gateway.md) — MCP server · 419019 installs
- [SparkForge](https://affpapa.org/en/nevibecode/mcp/sparkforge.md) — MCP server · 219896 installs
- [OpenWebSearch](https://affpapa.org/en/nevibecode/mcp/openwebsearch.md) — MCP server · 494 installs

---
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
