# Tool reference: every onecell MCP tool, by area

Every tool onecell gives your agent, grouped by area, with what it does and which ones a Drafts only key can use. Every change runs as a dry run first.

Your agent reaches onecell through these MCP tools. You rarely call them by name: you ask, and the agent picks. This page is for knowing what is possible, and what a **Drafts only** key allows.

> [!info]
> **Dry run by default.** Every tool that changes something runs as a dry run unless the agent passes `dry_run: false`. It sees what would happen first, then does it. The *Drafts only* column says whether a drafts-only key or sign-in can use the tool.

## Documents

| Tool | What it does | Drafts only |
| --- | --- | --- |
| create\_document | Create a draft in a cell, with blocks and tags | Yes |
| get\_document | Read a document, or just its outline, one section, or chosen blocks | Yes |
| update\_document | Change a document's title, summary, tags, cell or visibility; edit a few blocks by id (insert, replace, delete, move) or replace them all | Drafts only, and not cell or visibility |
| list\_documents | List documents in a cell, filtered by tags or date; also the trash | Yes |
| validate\_document | Check a document against the rules, including the stricter publishing ones | Yes |
| document\_history | Every version, newest first, with who wrote it | Yes |
| set\_status | Publish, archive, or return to draft | No |
| delete\_document | Move to the trash, kept for 30 days | No |
| restore\_document | Bring a document back from the trash | No |
| upload\_asset | Upload a small image or file for a document, sent through the conversation | Yes |
| create\_upload | Get a single-use link to upload a file from disk straight to onecell, without it passing through the conversation | Yes |

## Search, memory and decisions

| Tool | What it does | Drafts only |
| --- | --- | --- |
| search | Search by keyword and meaning; hits come with cell, headings and passage | Yes |
| recall | List or search remembered facts | Yes |
| get\_fact | Reload one fact by id, following any newer version | Yes |
| remember | Keep one sentence as a fact, in a cell or your Inbox | Yes |
| forget | Retire a fact; its history stays | No |
| list\_decisions | Every decision block, open by default, across clusters if asked | Yes |

## Cells and clusters

| Tool | What it does | Drafts only |
| --- | --- | --- |
| list\_cells | Your Inbox and the cells you can see, in one cluster or all | Yes |
| create\_cell | Open a new cell in the active cluster | No |
| move\_cell | Move a whole cell, with its documents and memory, to another cluster | No |
| list\_clusters | The clusters you belong to | Yes |
| get\_active\_cluster | The cluster you are working in | Yes |
| set\_active\_cluster | Switch clusters; your sidebar switches too | No |
| create\_cluster | Start a new cluster | No |
| join\_cluster | Accept an invitation to a cluster | No |

## Sharing and members

| Tool | What it does | Drafts only |
| --- | --- | --- |
| share\_cell | Share a cell with a member as viewer or editor, or open it to the whole cluster | No |
| list\_cell\_grants | Who a cell is shared with, and its cluster setting | Yes |
| revoke\_cell\_grant | Stop sharing a cell with someone | No |
| share\_document | Make a read-only link to one published document | No |
| list\_shares | Your active links | Yes |
| revoke\_share | Turn a link off | No |
| list\_members | Who is in the active cluster | Yes |
| invite\_member | Invite someone by email, or get a join link to paste | No |
| list\_invites | Invitations not yet accepted | Yes |
| resend\_invite | Send an invitation again | No |

## Hooks

| Tool | What it does | Drafts only |
| --- | --- | --- |
| hook\_event | Used by the onecell hooks in Claude Code and Codex, not called by the agent itself | Yes |

New tools appear as onecell ships them. If your agent says a tool is missing, reconnect onecell so it loads the current list.