# Deepmail Agent Setup

Deepmail gives coding agents and MCP-compatible assistants persistent email context through a local MCP server.

## Install

```bash
pip install deep-email
deep-email auth
```

## Install the Agent Skill

Use the Vercel Skills CLI pattern to add the Deepmail skill:

```bash
npx skills add dennisonbertram/deepmail
```

## Configure MCP

```bash
deep-email init
```

This writes `.mcp.json` for the current project. The MCP server runs locally over stdio and uses Gmail read-only OAuth.

## Useful Tools

- `search_emails` searches Gmail.
- `read_email` reads a specific message.
- `build_profile` builds persistent profile memory.
- `build_status` checks a running build.
- `who_is` looks up a person from cached profiles.
- `about_me` returns topic-specific context.
- `profile_health` checks freshness.
- `reset_profile` deletes generated profile data.