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.
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.