> ## Documentation Index
> Fetch the complete documentation index at: https://docs.char.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Use Char from other agents

> Connect Claude Code, Codex, Cursor, ChatGPT or another agent to your Char Pages, todos and History.

Your own AI agents can work in Char too. Connected to Char's MCP server, an agent can find and read your Pages, meetings and History, keep your todos, suggest work and write to your Pages, with the access you approve. Charlie keeps working inside Char, and the agent works on the same Pages from outside.

## Connect an agent in Char Next

1. Open **Settings → Apps**.
2. Choose **Claude Code**, **Cursor**, **ChatGPT** or **OpenCode**, then install it. Char adds its MCP server to that agent's settings.
3. Open the agent. The first time it uses Char, it opens a Char sign-in page in your browser. Sign in with your Char account and approve access.
4. Install the [Char skill](#install-the-char-skill) so the agent knows how to use Char.

## Connect any other agent

Give the agent Char's MCP server:

* **URL:** `https://api.char.com/v2/mcp`
* **Transport:** Streamable HTTP
* **Sign-in:** OAuth with your Char account. The agent opens the sign-in page for you.

An agent can also set itself up. Tell it:

> Set up Char by following [https://char.com/skills/char/references/setup.md](https://char.com/skills/char/references/setup.md)

| Agent | How to add Char |
| - | - |
| Claude Code | Run `claude mcp add --transport http --scope user char https://api.char.com/v2/mcp`, then `/mcp` to sign in |
| Codex | Run `codex mcp add char --url https://api.char.com/v2/mcp`, then `codex mcp login char` |
| Cursor | Add `"char": { "type": "http", "url": "https://api.char.com/v2/mcp" }` under `mcpServers` in `~/.cursor/mcp.json` |
| OpenCode | Add `"char": { "type": "remote", "url": "https://api.char.com/v2/mcp", "enabled": true }` under `mcp` in `~/.config/opencode/opencode.json`, then run `opencode mcp auth char` |
| Claude web and desktop | **Settings → Connectors → Add custom connector**, with the URL above |
| ChatGPT | Add a custom MCP connector in developer mode, with the URL above and OAuth |

## Choose what the agent can do

When you sign in, the agent asks for the access it needs:

| Access | What the agent can do |
| - | - |
| Read | Read your Pages, meetings and transcripts, todos, contacts, chats, Schedules and History |
| Edit | Create and edit Pages, todos, contacts and projects, suggest work on Home, and add to History |
| Delete | Delete Pages, contacts and todos, and merge contacts |
| Charlie | Change what Charlie does on its own, such as Skills and Schedules, and run Schedules, which uses your credits |

Read access is always included. An agent can't send messages in your chats, open attachments and recordings, or delete a meeting's Page. Its edits to a Page land as suggestions you accept or undo, and sync to every device. Work an agent suggests shows at the top of Home, and you accept or dismiss each todo. If an agent later needs access you didn't approve, it asks you to approve it.

What the agent does with your Pages after reading them depends on that agent and its provider. Connect only agents you trust with your Library.

## Install the Char skill

The Char skill teaches an agent what Home, Pages, daily pages, contacts, todos and History are, and which steps to take for everyday jobs such as finding a meeting, adding a todo or suggesting work. In Char Next, **Settings → Skills → Use Char in other agents** shows its files. They are also on char.com:

* [SKILL.md](https://char.com/skills/char/SKILL.md)
* [references/setup.md](https://char.com/skills/char/references/setup.md)
* [references/mcp.md](https://char.com/skills/char/references/mcp.md)
* [references/cli.md](https://char.com/skills/char/references/cli.md)

Save them in a folder named `char`, with the three references in a `references` folder inside it, in your agent's skill directory:

| Agent | Skill directory |
| - | - |
| Claude Code | `~/.claude/skills/char/` |
| Codex | `~/.codex/skills/char/` |
| Cursor | `~/.cursor/skills/char/` |
| OpenCode | `~/.config/opencode/skills/char/` |

For Claude's web and desktop apps, zip the `char` folder and upload it as a custom skill. For an agent without skills, add `SKILL.md` to its instructions.

## Check that it works

Start with a request that only reads:

> Use Char to list the todos due today.

Then try everyday work:

> In Char, find yesterday's meeting with Dana and list what we decided.

> Add a todo in Char to send the pricing deck tomorrow.

> Append a summary of this session to today's daily page in Char.

Open Char and check that the todo or the new text appears where you expect.

## If the agent can't connect

* **It keeps asking you to sign in:** the sign-in didn't finish. Remove Char from the agent, add it again, and complete the browser sign-in.
* **It says it lacks access:** you didn't approve that kind of access. Reconnect the agent and approve it.
* **Every request fails after sign-in:** your account isn't on Char Next yet. Agents can connect once it is.

To stop an agent using Char, remove the `char` server from that agent's settings.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.