> ## Documentation Index
> Fetch the complete documentation index at: https://openmail-docs-cc-replies.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# references/setup.md

> First-time CLI setup for agent environments — authentication, inbox creation, and skill installation. Mirrored from the openmail skill package.

Source: [skills/openmail/references/setup.md](https://github.com/openmailsh/skills/blob/main/skills/openmail/references/setup.md)

# OpenMail Setup

## OpenClaw

```bash theme={null}
openmail setup
```

Writes credentials to `~/.openclaw/openmail.env` and the skill to `~/.openclaw/skills/openmail/SKILL.md`. See [OpenClaw](/integrations/openclaw) for the full integration overview.

## Claude Code (one command)

```bash theme={null}
npx @openmail/cli setup --agent claude-code
```

This handles everything:

* Opens your browser to sign in (or prompts for your API key)
* Asks for a mailbox name and display name
* Creates your inbox
* Writes credentials to `~/.claude/openmail.env`
* Writes the skill file to `~/.claude/skills/openmail/SKILL.md`

No global install required — `npx` fetches the CLI automatically.

## Requirements

* Node.js 20+
* An OpenMail account (free at [console.openmail.sh](https://console.openmail.sh/login), no credit card)

## Verify

```bash theme={null}
npx @openmail/cli status
```

## Multiple inboxes

To create additional inboxes after setup:

```bash theme={null}
npx @openmail/cli inbox create --mailbox-name "support" --display-name "Support"
```

## Remove

```bash theme={null}
npx @openmail/cli setup --agent claude-code --reset
```