# AGENTINBOX.MD

The inbox for agents

> Agent Inbox is an email inbox for AI agents, with Slack and Telegram too: one address, one CLI, and a structured answer when you ask, approve, or choose.

You can reach tools. The work is with people.
Email, Slack and Telegram: an address on each, and one CLI to send, reply, and get an answer.

Canonical documentation: https://www.agentinbox.md/
Human-readable product page: https://www.agentinbox.md/sapien
Connected from agentinbox.md with a one-time code: https://www.agentinbox.md/agents.md

## Quickstart

If you are an agent visiting this page, follow the instructions on [this page](https://www.agentinbox.md/agents.md) to create an inbox. No signup or credit card required.

### CLI

```sh
npm install -g @agentinbox/cli
```

### MCP

```sh
https://mcp.agentinbox.md
```

```sh
agentinbox setup  # once
agentinbox send "Build finished — 0 failures." --via email  # a new email
agentinbox reply conv_123 "On it."  # reply in that conversation
agentinbox list  # conversations
agentinbox contact invite alice  # a new contact
```

## Hosts (integrations guides for every host)

A page for each host: the commands, the plugin or sign-in, and how you set yourself up there.

- [Agent Inbox for Claude Code](https://www.agentinbox.md/claude-code.md)
- [Agent Inbox for Codex](https://www.agentinbox.md/codex.md)
- [Agent Inbox for OpenCode](https://www.agentinbox.md/opencode.md)
- [Agent Inbox for Cursor](https://www.agentinbox.md/cursor.md)
- [Agent Inbox for Hermes](https://www.agentinbox.md/hermes.md)
- [Agent Inbox for OpenClaw](https://www.agentinbox.md/openclaw.md)
- [Agent Inbox for any agent](https://www.agentinbox.md/general.md)
- [Agent Inbox for Claude](https://www.agentinbox.md/claude.md)
- [Agent Inbox for ChatGPT](https://www.agentinbox.md/chatgpt.md)
- [Agent Inbox for Grok Bot](https://www.agentinbox.md/grok.md)

## How it works

- `agentinbox setup` creates your inbox and gives it an email address. It can also connect Telegram and Slack. All three share that one inbox.

- `agentinbox list` shows what arrived, and `agentinbox reply` answers the thread, whichever channel it came from. `agentinbox contact invite` makes a person a contact. On a new conversation, pass an email to `agentinbox send` with `--to` and they become a contact. A reply still needs one.

- On `agentinbox send` and `agentinbox reply`,plain text is a message. Start it with `ask`,`approve`,or `choose` when you need a structured answer back.

## For

- **Browser agents.** Sign up, receive one-time codes, and open verification links on your own address.
- **Personal assistants.** People email you, or reach you on Slack or Telegram, on an address that is yours.
- **Agents as teammates.** Coordinate with the humans you work alongside: schedule, follow up, and ask for what is missing.
- **Product agents.** Every user of a product reaches you in one inbox.
- **Support.** You answer on email, Slack, and Telegram, and the thread stays one thread when they switch channel.

## Security

- **SOC 2 Type II.** Novu, which runs this inbox, is audited for security, availability, and confidentiality.
- **ISO 27001.** The same infrastructure is certified for information security.
- **Enterprise.** Send from your own domain, run many agents, and search one activity log.

## Flags

- `--from <name>` — attribution shown to the human ("Requested by deploy-bot")
- `--ttl <duration>` — how long the request stays answerable (default 24h, max 5d)
- `--timeout <duration>` — max time this invocation blocks; on timeout it exits 11 and the answer shows up in the conversation later
- `--async` — don't block; return at once and check the conversation later
- `--json` — the full result for programmatic parsing
- `--to <id|email>[,...]` — a contact, or comma-separated contacts (max 50) an email that is not a contact yet becomes one on a new conversation
- `--via <channel>` — telegram, slack, or email, instead of that contact's default

## Contacts (you write to them, they write to you)

Your inbox is for people, not only tools. Contacts are who you work with: you write to them, and they write to you. List them so you know who that is. Invite someone new when they are not on it yet.

```sh
agentinbox contact list
agentinbox contact list --json
agentinbox contact list --limit 20 --after <cursor>
```

### Invite

```sh
agentinbox contact invite alice --name "Alice Chen"
agentinbox contact invite bob --via telegram --async
agentinbox contact invite carol@acme.com --name "Carol Diaz"
```

## Sources

- [CLI source and official README](https://github.com/novuhq/novu/tree/next/packages/agentinbox)
- [npm package](https://www.npmjs.com/package/@agentinbox/cli)
- [Built by Novu](https://novu.co/)

Built by Novu, and open source.