# Inkbox

> Identity layer for AI agents. Give your agents inboxes, phone numbers, and a secure vault.

Inkbox gives AI agents a persistent identity with a real inbox, phone number, and secure vault, so they can send emails, receive replies, answer calls, store credentials, and manage conversations as a single, consistent entity.

## Capabilities

- **Identities**: a persistent, named agent with unified communication channels
- **Email**: a real email address — send and receive email, manage threads, search inboxes
- **Phone**: a real phone number — make and receive calls, stream audio in real time
- **iMessage**: chat with humans in their native messaging app — tapbacks, read receipts, typing indicators, and media through the Inkbox iMessage router
- **Vault and 2FA**: store encrypted credentials, API keys, SSH keys, and TOTP configurations; generate two-factor authentication codes client-side while secrets remain zero-knowledge encrypted

## Getting started

Install the SDK:

```
pip install inkbox          # Python
npm install @inkbox/sdk     # TypeScript
npm install @inkbox/cli     # CLI
```

Get an API key at https://inkbox.ai/console, then follow the quickstart: https://inkbox.ai/docs/get-started/quickstart

## Resources

- Documentation (all, single file): https://inkbox.ai/docs/all.md
- Documentation (browsable): https://inkbox.ai/docs
- Documentation (sitemap with markdown links): https://inkbox.ai/sitemap.xml
- SDK (GitHub): https://github.com/inkbox-ai/inkbox
- Hermes Agent plugin — standalone Hermes platform plugin for Inkbox email, SMS/MMS, voice, contact rules, skills, and tunnels: https://github.com/inkbox-ai/hermes-agent-plugin
- OpenClaw plugin — standalone OpenClaw channel plugin for Inkbox email, SMS, voice, contacts, notes, and tunnels: https://github.com/inkbox-ai/openclaw-plugin
- Claude Code plugin — standalone Claude Code bridge for Inkbox email, SMS/MMS, iMessage, voice, contacts, and tunnels: https://github.com/inkbox-ai/claude-code-plugin
- Codex plugin — standalone Codex bridge for Inkbox email, SMS/MMS, iMessage, voice, contacts, and tunnels: https://github.com/inkbox-ai/codex-plugin
- OpenAPI spec (JSON): https://inkbox.ai/api/openapi.json
- OpenAPI spec (YAML): https://inkbox.ai/api/openapi.yaml
- Skills index: https://inkbox.ai/.well-known/skills/index.json

## Guides

- Get started > [Introduction](https://inkbox.ai/docs/get-started/introduction.md)
- Get started > [Quickstart](https://inkbox.ai/docs/get-started/quickstart.md)
- Get started > [Agent signup](https://inkbox.ai/docs/get-started/agent-signup.md)
- Capabilities > [Identities](https://inkbox.ai/docs/capabilities/identities.md)
- Capabilities > [Email](https://inkbox.ai/docs/capabilities/email.md)
- Capabilities > [Domains](https://inkbox.ai/docs/capabilities/email/custom-email-domains.md)
- Capabilities > [Mail apps (IMAP/SMTP)](https://inkbox.ai/docs/capabilities/email/mail-clients.md)
- Capabilities > [Phone](https://inkbox.ai/docs/capabilities/phone.md)
- Capabilities > [Inkbox Voice AI](https://inkbox.ai/docs/capabilities/phone/hosted-call-agent.md)
- Capabilities > [10DLC](https://inkbox.ai/docs/capabilities/phone/10dlc.md)
- Capabilities > [iMessage](https://inkbox.ai/docs/capabilities/imessage.md)
- Capabilities > [Tunnels](https://inkbox.ai/docs/capabilities/tunnels.md)
- Capabilities > [Contacts](https://inkbox.ai/docs/capabilities/contacts.md)
- Capabilities > [Notes](https://inkbox.ai/docs/capabilities/notes.md)
- Capabilities > [Vault](https://inkbox.ai/docs/capabilities/vault.md)
- API keys > [API keys](https://inkbox.ai/docs/api-keys.md)
- Webhooks > [Webhooks](https://inkbox.ai/docs/webhooks.md)
- Signing keys > [Signing keys](https://inkbox.ai/docs/signing-keys.md)
- Skills > [Overview](https://inkbox.ai/docs/skills/overview.md)
- Skills > [TypeScript SDK](https://inkbox.ai/docs/skills/typescript.md)
- Skills > [Python SDK](https://inkbox.ai/docs/skills/python.md)
- Skills > [Tunnels](https://inkbox.ai/docs/skills/tunnels.md)
- Skills > [Agent self-signup](https://inkbox.ai/docs/skills/agent-self-signup.md)
- Skills > [CLI](https://inkbox.ai/docs/skills/cli.md)
- Plugins > [Overview](https://inkbox.ai/docs/plugins/overview.md)
- Plugins > [Claude Code plugin](https://inkbox.ai/docs/plugins/claude-code.md)
- Plugins > [Codex plugin](https://inkbox.ai/docs/plugins/codex.md)
- Plugins > [Hermes Agent plugin](https://inkbox.ai/docs/plugins/hermes-agent.md)
- Plugins > [OpenClaw plugin](https://inkbox.ai/docs/plugins/openclaw-plugin.md)
- Plugins > [OpenCode plugin](https://inkbox.ai/docs/plugins/opencode-plugin.md)
- Examples > [Browser Use](https://inkbox.ai/docs/examples/browser-use.md)
- Examples > [Kernel](https://inkbox.ai/docs/examples/kernel.md)

## API Reference

- Agent signup API > [Overview](https://inkbox.ai/docs/api/agent-signup.md)
- Agent signup API > [Register](https://inkbox.ai/docs/api/agent-signup/register.md)
- Agent signup API > [Approve](https://inkbox.ai/docs/api/agent-signup/approve.md)
- Agent identity API > [Overview](https://inkbox.ai/docs/api/identities.md)
- Agent identity API > [Manage identities](https://inkbox.ai/docs/api/identities/manage.md)
- Agent identity API > [Agent visibility](https://inkbox.ai/docs/api/identities/access.md)
- Agent identity API > [Phone-number release](https://inkbox.ai/docs/api/identities/channels.md)
- Mail API > [Overview](https://inkbox.ai/docs/api/mail.md)
- Mail API > [Mailboxes](https://inkbox.ai/docs/api/mail/mailboxes.md)
- Mail API > [Messages](https://inkbox.ai/docs/api/mail/messages.md)
- Mail API > [Threads](https://inkbox.ai/docs/api/mail/threads.md)
- Mail API > [Search](https://inkbox.ai/docs/api/mail/search.md)
- Mail API > [Contact rules](https://inkbox.ai/docs/api/mail/contact-rules.md)
- Mail API > [Webhooks](https://inkbox.ai/docs/api/mail/webhooks.md)
- Phone API > [Overview](https://inkbox.ai/docs/api/phone.md)
- Phone API > [Phone numbers](https://inkbox.ai/docs/api/phone/numbers.md)
- Phone API > [Texts](https://inkbox.ai/docs/api/phone/texts.md)
- Phone API > [Calls](https://inkbox.ai/docs/api/phone/calls.md)
- Phone API > [Transcripts](https://inkbox.ai/docs/api/phone/transcripts.md)
- Phone API > [Incoming calls](https://inkbox.ai/docs/api/phone/incoming-call-action.md)
- Phone API > [Contact rules](https://inkbox.ai/docs/api/phone/contact-rules.md)
- Phone API > [SMS opt-ins](https://inkbox.ai/docs/api/phone/sms-opt-ins.md)
- Phone API > [Webhooks](https://inkbox.ai/docs/api/phone/webhooks.md)
- Phone API > [Media stream](https://inkbox.ai/docs/api/phone/media-stream.md)
- iMessage API > [Overview](https://inkbox.ai/docs/api/imessage.md)
- iMessage API > [Router](https://inkbox.ai/docs/api/imessage/router.md)
- iMessage API > [Agent avatar](https://inkbox.ai/docs/api/imessage/agent-avatar.md)
- iMessage API > [Messages](https://inkbox.ai/docs/api/imessage/messages.md)
- iMessage API > [Conversations](https://inkbox.ai/docs/api/imessage/conversations.md)
- iMessage API > [Tapbacks](https://inkbox.ai/docs/api/imessage/reactions.md)
- iMessage API > [Contact rules](https://inkbox.ai/docs/api/imessage/contact-rules.md)
- iMessage API > [Webhooks](https://inkbox.ai/docs/api/imessage/webhooks.md)
- Webhooks API > [Overview](https://inkbox.ai/docs/api/webhooks.md)
- Webhooks API > [Subscriptions](https://inkbox.ai/docs/api/webhooks/subscriptions.md)
- Webhooks API > [Deliveries](https://inkbox.ai/docs/api/webhooks/deliveries.md)
- Tunnels API > [Overview](https://inkbox.ai/docs/api/tunnels.md)
- Tunnels API > [Manage tunnels](https://inkbox.ai/docs/api/tunnels/manage.md)
- Tunnels API > [Passthrough TLS](https://inkbox.ai/docs/api/tunnels/passthrough.md)
- Contacts API > [Overview](https://inkbox.ai/docs/api/contacts.md)
- Contacts API > [Manage contacts](https://inkbox.ai/docs/api/contacts/manage.md)
- Contacts API > [Access control](https://inkbox.ai/docs/api/contacts/access.md)
- Contacts API > [vCards](https://inkbox.ai/docs/api/contacts/vcards.md)
- Notes API > [Overview](https://inkbox.ai/docs/api/notes.md)
- Notes API > [Manage notes](https://inkbox.ai/docs/api/notes/manage.md)
- Notes API > [Access control](https://inkbox.ai/docs/api/notes/access.md)
- Vault API > [Overview](https://inkbox.ai/docs/api/vault.md)
- Vault API > [Secrets](https://inkbox.ai/docs/api/vault/secrets.md)
- Vault API > [Keys](https://inkbox.ai/docs/api/vault/keys.md)
- Vault API > [Access control](https://inkbox.ai/docs/api/vault/access.md)
- Vault API > [Payload schemas](https://inkbox.ai/docs/api/vault/payloads.md)