# Inbot > Self-hosted, privacy-first email for AI agents. ## Docs - [Inbot documentation](https://inbot.kerd.dev/docs): Self-hosted, privacy-first email for AI agents. Each agent gets its own inbox on your domain, and mail stays encrypted on your machine. ## Get started - [Install Inbot](https://inbot.kerd.dev/docs/get-started/install): One-line installers, supported platforms, release verification, updates and removal. - [Quickstart](https://inbot.kerd.dev/docs/get-started/quickstart): From the first start of the service to an agent reading and answering mail in its own inbox, with your approval before anything is sent. - [Concepts](https://inbot.kerd.dev/docs/get-started/concepts): The words Inbot uses for people, credentials, mail resources and infrastructure, such as owner, agent, grant, inbox and buffer. ## Owner guides - [The owner app](https://inbot.kerd.dev/docs/guides/owner-app): Sign in to the local web app and find your way around mail, approvals, domains, API keys, remote access and settings. - [Mail transport](https://inbot.kerd.dev/docs/guides/transport): Create the Cloudflare API token Inbot needs, with every permission explained, then verify, save, rotate and clear it safely. - [Domains](https://inbot.kerd.dev/docs/guides/domains): Register a mail subdomain, review the plan, provision Cloudflare resources, verify delivery end to end, and tear it all down again. - [Inboxes and API keys](https://inbot.kerd.dev/docs/guides/inboxes-and-keys): Create, pause and delete inboxes, issue scoped API keys, choose permissions and send policies, and manage OAuth grants. - [Drafts and approvals](https://inbot.kerd.dev/docs/guides/approvals): How drafts, scheduled sends and owner approval work, and how to approve, reject or resolve a message whose outcome is unknown. - [Allow and block lists](https://inbot.kerd.dev/docs/guides/lists): Restrict who each inbox receives from, sends to and replies to with exact addresses or domains, and review the inbound mail that was rejected. - [Webhooks and events](https://inbot.kerd.dev/docs/guides/webhooks): Get notified when mail arrives or state changes, with signed webhooks or an authenticated WebSocket stream, and verify signatures correctly. - [Remote access](https://inbot.kerd.dev/docs/guides/remote-access): Let agents in the cloud reach your local Inbot through a named Cloudflare Tunnel, with a strict route allowlist. ## Agents - [Connect an agent](https://inbot.kerd.dev/docs/agents/connect): Give an agent access to its inbox over MCP, the CLI or REST, with an API key or OAuth, on your machine or through remote access. - [Connect Claude Code](https://inbot.kerd.dev/docs/agents/claude-code): Connect Claude Code to a local Inbot inbox over HTTP MCP, enter the API key without shell history, and install the Inbot skill. - [Reading and sending mail](https://inbot.kerd.dev/docs/agents/mail): The agent workflow for finding mail, reading it safely, replying with idempotency keys, and handling approval, failures and unknown outcomes. - [OAuth for MCP clients](https://inbot.kerd.dev/docs/agents/oauth): How MCP clients connect with owner-approved OAuth grants instead of API keys, with every endpoint, lifetime and rule. ## How it works - [Architecture](https://inbot.kerd.dev/docs/concepts/architecture): How mail flows into and out of Inbot, what runs on Cloudflare and on your machine, and how the service recovers after crashes and outages. - [Security model](https://inbot.kerd.dev/docs/concepts/security): What Inbot encrypts, what Cloudflare can see, how owners and agents are separated, and the limits of these protections. - [Message states](https://inbot.kerd.dev/docs/concepts/message-states): Send statuses, delivery labels, inbound labels and hidden labels, what each one means and proves, and what to do about each. ## Operations - [Running the service](https://inbot.kerd.dev/docs/operations/service): Start and stop inbot serve, install it as a per-user background service, understand startup output and unlock, read logs, back up the home, and know what runs in the background. - [Configuration](https://inbot.kerd.dev/docs/operations/configuration): Every serve flag, environment variable and flavor default, the files in the Inbot home directory, and the settings stored in the database. - [Troubleshooting](https://inbot.kerd.dev/docs/operations/troubleshooting): Find and fix common problems with startup, sign-in, agents, sending, receiving, domains, webhooks and remote access. ## Reference - [REST API](https://inbot.kerd.dev/docs/reference/rest): Every /v0 route with who may call it and the permission it needs, plus pagination, idempotency, composing rules, downloads and limits. - [MCP tools](https://inbot.kerd.dev/docs/reference/mcp): The 36 MCP tools Inbot serves, with the permission each one needs, its annotations and inputs, result truncation and error behavior. - [CLI reference](https://inbot.kerd.dev/docs/reference/cli): Every inbot command, argument and option, generated from the CLI's own help output each time the documentation is built. - [Events](https://inbot.kerd.dev/docs/reference/events): Every event type and payload, who can see it, how the durable and encrypted event log works, and the WebSocket subscription protocol. - [Permissions](https://inbot.kerd.dev/docs/reference/permissions): The 25 grant permissions, inbox scope rules, hidden-label permissions, send policies and owner-only capabilities. - [Errors and exit codes](https://inbot.kerd.dev/docs/reference/errors): Every Inbot error code with its HTTP status and meaning, the error body shape shared by REST and MCP, and the stable inbot CLI exit codes. ## Development - [Build from source](https://inbot.kerd.dev/docs/development/build): Build and run Inbot from a source checkout, run the checks the project uses, and build this documentation site locally. - [Packaging and releases](https://inbot.kerd.dev/docs/development/packaging): Build release archives for every platform, smoke-test them locally, and how the release workflow signs, notarizes, attests and publishes archives. ## Agent resources - [llms-full.txt](https://inbot.kerd.dev/docs/llms-full.txt): The full Markdown of every page in one file. - [Page Markdown](https://inbot.kerd.dev/docs/index.md): Append `.md` to any page URL to fetch that page as raw Markdown. - [JSON API](https://inbot.kerd.dev/docs/api/docs/pages.json): Page index of the JSON docs API; each entry links the page's JSON and Markdown forms. Described by the OpenAPI document at https://inbot.kerd.dev/docs/openapi.json. - [API catalog](https://inbot.kerd.dev/docs/.well-known/api-catalog): RFC 9727 linkset of the APIs documented here. - [AI catalog](https://inbot.kerd.dev/docs/.well-known/ai-catalog.json): ARD manifest of the agent-facing resources on this site (MCP server, skills, APIs). - [agent-readability.json](https://inbot.kerd.dev/docs/agent-readability.json): Manifest of every agent-facing artifact on this site. - [Sitemap](https://inbot.kerd.dev/docs/sitemap.xml): Every indexable page URL with its last-modified date.