# Revdoku

MCP server that gives each agent its own mailbox with an incoming email address and file storage. The agent reads mail, retrieves attachments, and works with versioned documents.

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

## What it does

Every mailbox gets its own email address. The agent reads incoming messages with `mailbox_email_list`, downloads attachments, and replies through `mailbox_email_send`. Emails are stored as `message.eml`, decoded JSON, and attachment files. When the mailbox requires approval, a person reviews each outgoing message in the dashboard before it goes out.

Mailboxes also store project files with version history. The agent uploads folders via CLI (`revdoku upload ./project-files`), reads changes, and restores earlier file versions. Multiple agents coordinate edits on shared files with locks and version checks.

The server runs over HTTP at `https://app.revdoku.com/mcp` and requires the `REVDOKU_API_KEY` variable. SDKs for TypeScript (Node.js 22+) and Python 3.10+ are available through npm and pip. New accounts start on the Free plan.

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

## Install

### Claude Code (native platform)

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

### Codex

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

### Cursor

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

### GitHub Copilot

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

### Gemini CLI

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

## When to use it
- Receive invoices, documents, and project updates at an agent's email address
- Collect attachments from incoming mail and pass them to the agent for processing
- Upload a project folder to storage and roll back a file to an earlier version
- Send an email from the mailbox in reply to an incoming message
- Coordinate multiple agents working on shared files

## Example prompts
- Connect Revdoku and set up a mailbox for incoming invoices
- Show all emails in mailbox `bkt_...` from the past three days
- Upload the `./docs` folder to the mailbox and list versions of `spec.md`

## Similar
- [api-versioning-strategy](https://affpapa.org/en/nevibecode/skills/api-versioning-strategy.md) — skill · 399 installs
- [resend](https://affpapa.org/en/nevibecode/skills/resend.md) — skill · 23400 installs
- [api-design](https://affpapa.org/en/nevibecode/skills/aaronontheweb-api-design.md) — skill · 660 installs
- [api-changelog-versioning](https://affpapa.org/en/nevibecode/skills/api-changelog-versioning.md) — skill · 402 installs
- [postmark](https://affpapa.org/en/nevibecode/skills/postmark.md) — skill · 784 installs
- [loops-api](https://affpapa.org/en/nevibecode/skills/loops-api.md) — skill · 1600 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