# Email Inbox for OpenHands | Revdoku

> Give OpenHands an inbox for the software tasks you assign. Let it read incoming requests and attachments in the environment where it works.

Email for OpenHands

Give OpenHands its own email address!

Give OpenHands an inbox for the software tasks you assign. Let it read incoming requests and attachments in the environment where it works.

Create your AI agent’s inbox

Connect AI…

Copy this setup prompt and paste it into ChatGPT, Claude or another AI app. It walks you through signup and connecting.

Copy setup prompt

Connect Revdoku so you can create and manage email mailboxes for my AI agents, read emails and attachments, and store files. Follow https://revdoku.com/llms-install.md to set up access.

Developer options
Skill MCP cURL TS/JS Python

npx skills add revdoku/revdoku --skill revdoku -g

For Claude Code, Codex, Cursor and other coding agents.

https://mcp.revdoku.com

Add as a custom connector in Claude, ChatGPT or Cursor. Steps

curl https://api.revdoku.com/v1/mailboxes \
-H "Authorization: Bearer $REVDOKU_API_KEY" \
-H "Content-Type: application/json" \
-d '{"mailbox": {"email": {
"username": "acme-orders",
"domain": "revdokumail.com"}}}'

Creates a mailbox with your API key. API reference

const key = process.env.REVDOKU_API_KEY;
const url = "https://api.revdoku.com/v1/mailboxes";
const res = await fetch(url, {
method: "POST",
headers: {
Authorization: `Bearer ${key}`,
"Content-Type": "application/json",
},
body: JSON.stringify({ mailbox: { email: {
username: "acme-orders",
domain: "revdokumail.com",
} } }),
});
console.log(await res.json());

Creates a mailbox with your API key. API reference

import os, requests
key = os.environ["REVDOKU_API_KEY"]
res = requests.post(
"https://api.revdoku.com/v1/mailboxes",
headers={"Authorization": f"Bearer {key}"},
json={"mailbox": {"email": {
"username": "acme-orders",
"domain": "revdokumail.com",
}}},
timeout=30,
)
print(res.json())

Creates a mailbox with your API key. API reference

How it works

1 A new email arrives
Someone emails your agent’s address. Revdoku tells your agent right away.

2 Your agent opens it
It reads the email and its attachments when it needs them.

3 Every read is logged
The audit log shows each email and file your agent opened, and why.

4 Your agent gets the data
It uses what it found and can reply to the sender.

AI agent New email Reading… Got the data

myagent@ revdokumail.com

team@acme.studio New
Project brief
brief.pdf

noreply@github.com
Your sign-in code

Audit log

Read email ✓
Reason: find the project brief

Read file brief.pdf ✓
Reason: check the requirements

Use your inbox to

Investigate reported bugs
Forward a bug report and ask OpenHands to prepare a fix for review.

Use emailed sample data
Give the agent a sample file to reproduce an import error in its workspace.

Check test messages
Inspect emails from your app while OpenHands works on a registration flow.

Connect OpenHands

In Agent Canvas, open Customize → MCP Servers → Add custom server. Select SHTTP, enter the Revdoku URL, and choose OAuth. Sign in, test the connection, and start a new conversation.

MCP URL: https://mcp.revdoku.com

Revdoku MCP guide · OpenHands documentation · All AI apps

---

[View the canonical page](https://revdoku.com/openhands/) · [Browse llms.txt](https://revdoku.com/llms.txt)