Get an overview of the Second Brain: counts of notes, containers, tags, inbox items, and recent notes.

No parameter schema in public metadata yet.

Unified search across notes, containers, and tags. Returns results grouped by type. Use the types parameter to search only specific types (e.g., types: ['notes'] for note-only search). Supports full-text search with snippets, all note filters (container, tags, include_nested,...

List notes with optional filtering and sorting. Returns paginated results. Use team_id to list notes in a team. Use container_id to list notes in a specific container (with include_nested for sub-containers). Use tag/tags/tag_ids to filter by tags.

Get a single note by ID, including its full body content, tags, container, linked notes, and file attachments.

Create a new note. The body supports Markdown and wiki-links: use [[id:Note Title]] to link to other notes. Use team_id to create in a team.

Update an existing note. Supports updating content, moving to a container, changing tags, archiving (archived: true/false), and favoriting (favorited: true/false).

Permanently delete a note.

List containers (folders) for organizing notes. By default returns root-level personal containers. Use team_id to list containers in a team.

Get a single container by ID, including its LLM instructions if set. Use include_tree to also get ancestors and children.

Create a new container (folder) for organizing notes.

Update an existing container (rename, change description, move to a different parent, or set display position).

List all tags.

Create a new tag.

List all teams the user is a member of.

No parameter schema in public metadata yet.

Get team details including recent notes.

Get LLM instructions at the specified level. Use level 'brain' to get global instructions (call early in conversations). Use 'personal_root' for personal space, 'container' for a specific container (includes inheritance chain), or 'team' for team instructions.

Update LLM instructions at the specified level. Use 'brain' for global, 'personal_root' for personal space, 'container' for a specific container, or 'team' for team instructions.

Create or remove a bidirectional link between two notes.

Attach a file to a note. Send the file contents as a base64-encoded string.

Fetch a file from a URL and attach it to a note. Follows one redirect.

Remove a file attachment from a note.

Generate a one-time upload URL for attaching a file to a note. Share this URL with the user so they can upload their file directly — the file bypasses the conversation and goes straight to Second Brain, saving tokens. The link expires after 30 minutes. Use files-check_upload t...

Check the status of a file upload link created by files-create_upload_url. Returns 'pending' (user hasn't uploaded yet), 'completed' (file attached successfully), or 'expired' (link timed out).

Get a temporary download URL for a file attached to a note. Share the URL with the user so they can download the file in their browser. The URL expires after a few minutes.