hjarni

Create a new container (folder) for organizing notes.

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

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

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

Get an overview of the Second Brain: counts of notes, containers, tags, inbox items, and recent 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.

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

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 to verify the upload completed.

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.

Remove a file attachment from a note.

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.

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.

Permanently delete a note.

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

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.

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

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, search_scope), and archived note search via scope parameter.

Create a new tag.

List all tags.

Get team details including recent notes.

List all teams the user is a member of.