brain

Send a new message from one connected account. The account is yours to name and every send needs an idempotency key. Text only, no HTML. The message is marked as an agent's inside Brain: the owner sees it in Settings, Connections.

Reply to one message in a thread. The recipients are derived from the message being answered, Reply-To over From, with this account's own addresses dropped; there is no `to` here. To write to someone else, send a new message. Text only, no HTML.

Report what became of one send: its status, and the thread its Sent copy landed in once the provider has one. A send whose account has no Sent folder keeps a null thread for good. Name the account as well after a send answered `state` unknown, so the owner's Sent row can still say which app wrote th…

List the connected mail accounts, each with whether this host can send from it and why not when it cannot.

List one account's threads in one system mailbox, newest first. Pass `nextCursor` back as `cursor` for the next page.

Search cached thread headers and previews. Message bodies are never searched. With no `accountId` every account is searched and the results merge newest first behind one cursor.

Read one thread: its row and every message's headers, preview and whether a body is already cached. Bodies come from read_mail_message.

Read one message's plain-text body and its attachment list. Answers `state` fetching when the body is still on its way, and the caller asks again.

Sort one thread: mark it read or unread, star it, archive it, move it to trash or spam, or restore it from either. Exactly one of the six per call, which is the shape the service's own PATCH takes. There is no purge: a thread in the trash stays there until the person empties it.

List the tasks of one list, or every record on one note. Pass the caller's own local calendar date as `today`; leave it out and Brain uses the owner's own time zone. Every list but `logbook` answers `{tasks}`, one record each; `logbook` answers `{entries}`, one per completion, because a repeating ta…

Read one task record, including whether its note line was removed and which page it is linked to.

Make a task. It is unlinked: it owns its own completion and belongs to no note. To turn a checkbox line of a note into a task, use promote_task_line. `time` and `evening` are statements about a day, so both need `when` to be a day rather than `someday`.

Turn one checkbox line of a note into a task linked to that line. `line` is a zero-based markdown line number, or the line's own text with runs of whitespace collapsed. The note's category is inherited unless one is named here. The line keeps owning the task's title and its completion. Takes no `rev…

Change one task. A field left out is left alone and `null` clears it. `when` takes a day, the word `someday`, or null for the Inbox. `time` and `evening` are statements about a day, so a change that parks the task or sends it back to the Inbox clears both whether or not they are named here. Clearing…

Tick one task. `today` is the caller's own local calendar date and is required: the answer says which list the record is in for that day, and a repeating task's next occurrence is computed from it. The server has no timezone of the caller's to fall back on. A completion stays in the list it was in, …

Untick one task. `today` is the caller's own local calendar date and is required: the answer says which list the record lands back in for that day. Unticking a repeating task restores the instance its newest completion came from.

Delete one task record. A linked task's checkbox line stays in its note; the record that pointed at it is what goes.

List the full page tree of the notebook (ids, titles, icons, nesting).

Verify this MCP connection can authenticate and read Brain without changing any pages. Reports whether write, import, and mail access are authorized, but does not exercise those permissions.

Read a page's markdown by id. Returns meta, markdown, and rev (needed for write_page).

Replace a page's markdown. Pass the rev from read_page for conflict safety; omit to force.

Create a page. parentId null/omitted = top level. Returns the new page's meta (id).

Find the Brain page for one Notion id and report server-computed import baseline, lease, and optional candidate-token ownership integrity without returning the token.

Inspect one explicitly selected Brain page for preserve/adopt using only rev, placement, and redacted Notion binding state.

Bind a verified existing Brain page to one Notion source without changing its content or hierarchy. Read the page immediately before adoption and pass its rev plus the conversion hash for that exact target.

Atomically find-or-reserve a Notion page before converting content. Pass one maps ids; pass two supplies conversionHash and desired beforeId after every sibling id is known. Never retries at root.

Upload one converted Notion attachment under an active page reservation.

Read and hash one staged attachment under the matching active Notion reservation.

Read and hash one permanent attachment owned by an intact finalized Notion target.

Finalize a reserved Notion page. Refuses stale tokens and concurrent edits. Finalize parents before children and each sibling group from last to first (the next beforeId target must already be stable).

Release a token-owned Notion reservation without overwriting the current page body.

Update page metadata: title, icon, category, kanban status, view ('board' turns a page with children into a kanban board). public:false may revoke sharing; only the owner disclosure flow can enable it.

Delete a page and its whole subtree. Soft-delete — recoverable from Trash.

Full-text search across all pages. Returns matching pages with snippets.