Email inboxes for AI agents.

Give your AI agent its own email address. Receive messages through the API, process requests and connect your inbox to your workflows.

Try a mailbox Connect your agent

Start without signing in. No credit card required.

Live Inbox

Just for you

curl --fail-with-body --silent --show-error \
  --proto '=https' --max-redirs 0 \
  --request POST 'https://services.getridian.com/v1/mailboxes' \
  --header @"$RIDIAN_SETUP_HEADERS" \
  --header 'Content-Type: application/json' \
  --data '{}' --output "$RIDIAN_MAILBOX_RESPONSE"

Use saved setup credentials; the response contains private keys. Prepare →

ridian-mailbox \
  --base-url 'https://services.getridian.com' \
  --state "$HOME/.config/ridian/mailbox-services.getridian.com.json" setup

Install CLI · One command. Credentials saved, address ready.

from ridian_mailbox import Mailbox

client = Mailbox(base_url="https://services.getridian.com")
inbox = client.setup()
print(inbox["address"])

Install Python package · PyPI 0.1.0a4 · Python 3.10+

import { Mailbox } from "@ridian/mailbox";

const client = new Mailbox({ baseUrl: "https://services.getridian.com" });
const inbox = await client.setup();
console.log(inbox.address);

Install TypeScript package · Node.js 22+

An inbox for your agent.

Let your agent get started, or connect it yourself.

Task for your agent

Read https://docs.getridian.com/skills/ridian-mailbox/SKILL.md and set up my private Ridian mailbox. Reuse existing access and store new credentials securely.

Your agent reads the instructions itself. It needs HTTPS tools and private, persistent storage.

SKILL.md Full guide OpenAPI

In Ridian, open AI & Assistants, choose ChatGPT and connect.
Select the mailbox and permissions. Then ask your assistant to read the inbox.

Open AI & Assistants →

To use the address above, claim the browser inbox first.

~/.cursor/mcp.json

{
  "mcpServers": {
    "ridian": {
      "url": "https://api.getridian.com/mcp"
    }
  }
}

Add the ridian entry, keeping existing servers. Then sign in to Ridian from Cursor and authorize the mailbox.

Full guide →

To use the address above, claim the browser inbox first.

Run in your project

mkdir -p .claude/skills/ridian-mailbox
curl --fail --silent --show-error \
  'https://docs.getridian.com/skills/ridian-mailbox/SKILL.md' \
  --output .claude/skills/ridian-mailbox/SKILL.md

Review the file, then invoke /ridian-mailbox.

Dedicated receiving access · Requires HTTPS and private, persistent storage.

Full guide →

Run in your OpenClaw workspace

mkdir -p skills/ridian-mailbox
curl --fail --silent --show-error \
  'https://docs.getridian.com/skills/ridian-mailbox/SKILL.md' \
  --output skills/ridian-mailbox/SKILL.md

Review the file and ask OpenClaw to use the ridian-mailbox skill.

Dedicated receiving access · Requires HTTPS and private, persistent storage.

Full guide →

Run in your terminal

hermes skills install 'https://docs.getridian.com/skills/ridian-mailbox/SKILL.md'

Review the skill during installation, then ask Hermes to use it.

Dedicated receiving access · Requires HTTPS and private, persistent storage.

Full guide →

Open Plugins → Add custom → Connector → Add MCP connector.
Choose Remote, Streamable HTTP and OAuth. Enter Ridian as the name and this URL:

https://api.getridian.com/mcp

Open the connector, sign in to Ridian and authorize the mailbox.

Requires custom remote connectors on your account and admin approval where applicable.

Full guide →

To use the address above, claim the browser inbox first.

What your agent can do with it.

A dedicated address. Clear tasks. You choose the permissions.

Sign in without switching inboxes

Your agent receives verification emails and sign-in codes in its own inbox and uses them for the sign-in you requested.

Mailbox read access and your agent’s browser tools

Prompt for your agent

Use my agent inbox for the sign-in I requested. Read the matching verification email and use its code or confirmation link with the expected service. Do not share codes in chat. Ask if the service or account is unclear.

Invoices in one clear overview

Forward receipts to your agent. It creates a reviewable overview of senders, amounts and due dates.

Receiving and attachments; analysis by your agent

Prompt for your agent

Turn this month’s invoices into a table with sender, date, amount, currency and due date. Identify the source message and flag uncertain values. Do not make payments.

Respond to inquiries faster

Give a project its own contact address. Your agent organizes inquiries and prepares replies for review.

Drafts and sending after claim and MCP authorization

Prompt for your agent

Sort the new messages in my project mailbox by topic and urgency. Save reply drafts for the open questions. Do not send anything yet.

From email to a booked meeting

Connect mailbox and calendar. Your agent finds free times, prepares proposals and creates the confirmed event.

Separate mailbox, sending and calendar permissions

Prompt for your agent

Find three free 30-minute slots next week and prepare an email with these proposals. Send after my approval. Create the confirmed event only when I ask.

Your agent acts on your request. For automated workflows, connect events or webhooks to your own agent system.

Examples and guide →

Try it first. Connect it next.

Receive

Your own address with private messages and events for your agent.

Claim

Authorize

Choose your assistant’s mailbox permissions. Authorize sending and calendars separately.