Summary
A hosted note-taking system that gives Claude and ChatGPT direct access to your Markdown notes through a remote MCP server. Connect via OAuth in under two minutes with no local setup. Exposes tools for full CRUD on notes, folders, and tags, plus full-text search, wiki-style bidirectional linking, and file attachments. Each folder can have custom AI instructions that guide how the agent works with notes inside it. The dashboard tool gives agents an overview of your knowledge base structure. Works with Claude Desktop, Claude.ai, ChatGPT, and any client supporting streamable HTTP transport. Useful when you want your AI to remember things across conversations and actively manage a personal knowledge base instead of just answering one-off questions.
Keeps your Mac awake while Claude Code, Codex or Cursor works. Lets it sleep when they are done.
Try free for 7 days →
Block distracting apps from your iPhone permanently without a 3rd party app. Free and open source.
Block now (100% free) →
Notes, actions and memory. Without a meeting bot. First month 100% off.
Download for free →
belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →
Free an open-source skills that make AI coding agents easier to understand, verify, and control.
Download for free →
Connect your Claude agent to live crypto prices and trading routes via 1inch
Get the MCP →Tools
Public tool metadata for what this MCP can expose to an agent.
24 tools
dashboard-getGet an overview of the Second Brain: counts of notes, containers, tags, inbox items, and recent notes.
Get an overview of the Second Brain: counts of notes, containers, tags, inbox items, and recent notes.
No parameter schema in public metadata yet.
searchUnified 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,...8 params
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,...
Parameters* required
container_idintegerFilter note results to this container (ignored when search_scope is 'all')
include_nestedbooleanInclude notes from sub-containers when container_id is set (default: false)
querystringSearch query string
scopestringSearch active or archived notes (default: active)one of
active · archivedsearch_scopestringSearch scope: 'all' (default, personal + all teams), 'personal' (personal notes only), or 'team:<id>' (specific team). Applies to note results.
tag_idsarrayFilter note results to notes with ALL these tags (by ID)
tagsarrayFilter note results to notes with ALL these tags (by name)
typesarrayWhich types to search. Defaults to all three: ['notes', 'containers', 'tags']
notes-listList 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.10 params
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.
Parameters* required
container_idintegerFilter by container ID
include_nestedbooleanInclude notes from sub-containers when container_id is set (default: false)
pageintegerPage number (default: 1)
per_pageintegerResults per page, max 100 (default: 25)
scopestringFilter scope (default: active). 'inbox' and 'favorited' only for personal notes.one of
active · archived · inbox · favoritedsortstringSort order: 'recent' (updated_at desc, default), 'oldest' (updated_at asc), or 'title' (alphabetical)one of
recent · oldest · titletagstringFilter by tag name
tag_idsarrayFilter to notes with ALL these tags by ID (AND logic)
tagsarrayFilter to notes with ALL these tags by name (AND logic)
team_idintegerList notes in this team instead of personal notes
notes-getGet a single note by ID, including its full body content, tags, container, linked notes, and file attachments.1 params
Get a single note by ID, including its full body content, tags, container, linked notes, and file attachments.
Parameters* required
idintegerNote ID
notes-createCreate 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.7 params
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.
Parameters* required
bodystringNote body content (Markdown with [[id:Note Title]] wiki-links)
container_idintegerContainer ID to place the note in
source_urlstringSource URL reference
summarystringShort summary of the note
tag_liststringComma-separated list of tags
team_idintegerCreate note in this team instead of personal space
titlestringNote title
notes-updateUpdate an existing note. Supports updating content, moving to a container, changing tags, archiving (archived: true/false), and favoriting (favorited: true/false).9 params
Update an existing note. Supports updating content, moving to a container, changing tags, archiving (archived: true/false), and favoriting (favorited: true/false).
Parameters* required
archivedbooleanArchive (true) or unarchive (false) the note. Personal notes only.
bodystringNew body content (Markdown with [[id:Note Title]] wiki-links)
container_idintegerMove to this container
favoritedbooleanFavorite (true) or unfavorite (false) the note. Personal and team notes.
idintegerNote ID
source_urlstringNew source URL
summarystringNew summary
tag_liststringNew comma-separated tag list
titlestringNew title
notes-deletePermanently delete a note.1 params
Permanently delete a note.
Parameters* required
idintegerNote ID
containers-listList containers (folders) for organizing notes. By default returns root-level personal containers. Use team_id to list containers in a team.4 params
List containers (folders) for organizing notes. By default returns root-level personal containers. Use team_id to list containers in a team.
Parameters* required
pageintegerPage number
per_pageintegerResults per page
scopestringFilter scope (default: roots). 'archived' only for personal containers.one of
roots · all · archivedteam_idintegerList containers in this team instead of personal containers
containers-getGet a single container by ID, including its LLM instructions if set. Use include_tree to also get ancestors and children.2 params
Get a single container by ID, including its LLM instructions if set. Use include_tree to also get ancestors and children.
Parameters* required
idintegerContainer ID
include_treebooleanInclude ancestors and children arrays (default: false)
containers-createCreate a new container (folder) for organizing notes.3 params
Create a new container (folder) for organizing notes.
Parameters* required
descriptionstringContainer description
namestringContainer name
parent_idintegerParent container ID for nesting
containers-updateUpdate an existing container (rename, change description, move to a different parent, or set display position).5 params
Update an existing container (rename, change description, move to a different parent, or set display position).
Parameters* required
descriptionstringNew description
idintegerContainer ID
namestringNew name
parent_idintegerNew parent container ID (null for root)
positionintegerDisplay order position (lower numbers appear first)
tags-listList all tags.2 params
List all tags.
Parameters* required
pageintegerPage number
per_pageintegerResults per page
tags-createCreate a new tag.1 params
Create a new tag.
Parameters* required
namestringTag name
teams-listList all teams the user is a member of.
List all teams the user is a member of.
No parameter schema in public metadata yet.
teams-getGet team details including recent notes.1 params
Get team details including recent notes.
Parameters* required
idintegerTeam ID
instructions-getGet 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.2 params
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.
Parameters* required
idintegerContainer ID or Team ID (required for 'container' and 'team' levels)
levelstringInstruction level: 'brain' (global), 'personal_root', 'container', or 'team'one of
brain · personal_root · container · teaminstructions-updateUpdate 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.3 params
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.
Parameters* required
idintegerContainer ID or Team ID (required for 'container' and 'team' levels)
instructionsstringThe full updated instructions text. This replaces the existing instructions entirely.
levelstringInstruction level to updateone of
brain · personal_root · container · teamlinks-manageCreate or remove a bidirectional link between two notes.3 params
Create or remove a bidirectional link between two notes.
Parameters* required
actionstringAction: 'link' to create a link, 'unlink' to remove itone of
link · unlinksource_note_idintegerFirst note ID
target_note_idintegerSecond note ID
files-attachAttach a file to a note. Send the file contents as a base64-encoded string.5 params
Attach a file to a note. Send the file contents as a base64-encoded string.
Parameters* required
content_typestringMIME type (e.g. application/pdf). Defaults to application/octet-stream
datastringBase64-encoded file contents
descriptionstringOptional file description
filenamestringFilename (e.g. report.pdf)
idintegerNote ID
files-attach_from_urlFetch a file from a URL and attach it to a note. Follows one redirect.5 params
Fetch a file from a URL and attach it to a note. Follows one redirect.
Parameters* required
content_typestringOverride MIME type (default: from HTTP response)
descriptionstringOptional file description
filenamestringOverride filename (default: derived from URL)
idintegerNote ID
urlstringURL to fetch the file from
files-removeRemove a file attachment from a note.2 params
Remove a file attachment from a note.
Parameters* required
file_idintegerFile ID (from notes-get response)
note_idintegerNote ID
files-create_upload_urlGenerate 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...2 params
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...
Parameters* required
descriptionstringOptional file description
note_idintegerNote ID to attach the file to
files-check_uploadCheck 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).1 params
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).
Parameters* required
tokenstringUpload token (from files-create_upload_url response)
files-get_download_urlGet 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.2 params
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.
Parameters* required
file_idintegerFile ID (from notes-get response)
note_idintegerNote ID
Hjarni
Give your AI long-term memory.
Note-taking app with a built-in MCP server.
What it does
Hjarni is an AI-native note-taking app. Write notes in Markdown, organize them in folders with custom AI instructions per folder, and let Claude or ChatGPT search, read, create, and organize your notes via MCP.
Your notes serve two readers: you and your AI. Hjarni stores the knowledge. ChatGPT and Claude are the interfaces.
Connect
Hjarni is a hosted remote MCP server with OAuth authentication. No API keys, no Docker, no local setup. Setup takes under 2 minutes.
Claude.ai / Claude Desktop / Claude mobile
Hjarni is in the Claude Connectors Directory: open the listing, click Connect, and sign in.
Or add it by URL:
- Open Customize > Connectors
- Click + then Add custom connector
- Enter the URL
https://hjarni.com/mcp - Click Add and log in to Hjarni when redirected
Connectors are available on all Claude plans (Free is limited to one). On Team and Enterprise, a workspace owner adds the connector first.
Claude Code
claude mcp add --transport http hjarni https://hjarni.com/mcp
Add --scope user to make it available in every project. Then run /mcp inside Claude Code to complete the OAuth sign-in.
ChatGPT
Hjarni is in the ChatGPT Apps Directory: open the app page, click Connect, and sign in.
Or add it by URL via developer mode:
- Go to Settings > Apps > Advanced settings and enable Developer mode
- Click Create app
- Set the MCP Server URL to
https://hjarni.com/mcpand authentication to OAuth - Click Create and log in to Hjarni when redirected
Requires a paid ChatGPT plan (Plus, Pro, Business, Enterprise, or Education).
Other MCP clients
Any client that supports streamable HTTP transport can connect. The endpoint is https://hjarni.com/mcp. Authentication uses OAuth 2.0 with PKCE. Discovery metadata is at /.well-known/oauth-authorization-server.
Setup guides: Cursor · Copilot · Copilot Studio · Perplexity · Raycast
Available tools
| Tool | Description |
|---|---|
me | The connected user's profile, plan, teams, note quota, and onboarding state |
dashboard-get | Overview of the account: counts, recent notes, and recent changes across all spaces |
search | Full-text search across notes, containers, and tags |
notes-list | List notes with filtering by container, tags, and sorting |
notes-get | Read a single note: full body, tags, links, backlinks, files, and inherited AI instructions |
notes-create | Create a new note with title, body, summary, tags, and container placement |
notes-update | Update content, move notes, change tags, archive or favorite |
notes-delete | Move a note to Trash (recoverable for 30 days) |
notes-restore | Restore a note from Trash |
notes-history | Read a note's revision history: who wrote each version, when, and what changed |
notes-revert | Revert a note's body to an earlier revision (appends a new revision, so it can be undone) |
containers-list | List folders for organizing notes |
containers-get | Get a single container with its description and AI instructions |
containers-create | Create new folders |
containers-update | Update a container (rename, move, change description, archive) |
containers-permissions | Set or clear a team member's role on a team container |
containers-delete | Move a folder, its sub-folders, and their notes to Trash (recoverable for 30 days) |
containers-restore | Restore a deleted folder and everything deleted with it |
tags-list | List all tags |
tags-create | Create new tags |
tags-manage | Rename, merge, or delete a tag |
links-manage | Create or remove bidirectional links between notes |
instructions-get | Read AI instructions at brain, personal root, container, or team level |
instructions-update | Update AI instructions at any level (replace or append) |
files-attach | Attach a file to a note (base64) |
files-attach_from_url | Fetch a file from a URL and attach it to a note |
files-create_upload_url | Generate a one-time upload link so the user uploads straight from the browser |
files-check_upload | Check the status of an upload link |
files-get_download_url | Get a temporary download URL for a file |
files-remove | Remove a file attachment |
email-addresses-list | List email capture addresses (Pro) |
email-addresses-create | Create an email capture address: mail sent to it becomes a note (Pro) |
teams-list | List all teams the user is a member of |
teams-get | Get team details including recent notes |
teams-create | Create a new team |
teams-invite | Invite a teammate by email or get a shareable join link |
feedback-submit | Send feedback about Hjarni to the maintainers |
nudges-dismiss | Dismiss a product suggestion the user declined |
Built-in prompts
The server also exposes MCP prompts for clients that support prompt discovery:
| Prompt | Description |
|---|---|
summarize_note | Summarize a note and suggest tags and related links |
weekly_review | Review recent activity and suggest organization improvements |
research_topic | Synthesize everything in the knowledge base related to a topic |
MCP Apps
On hosts that support MCP Apps (the io.modelcontextprotocol/ui extension, e.g. Claude and ChatGPT), files-create_upload_url renders an inline drop-zone so files upload straight into a note from the chat. Other clients get the plain upload link.
Usage examples
Research assistant
"What decisions have I made about the tech stack?"
Claude searches your notes, follows wiki-links between related notes, and synthesizes a summary from multiple sources.
Quick capture
"Save this as a note in my Projects folder and tag it"
Claude finds the right container, creates the note with Markdown formatting, adds tags, and links it to related notes.
Weekly review
"Help me triage my inbox"
Claude lists unfiled notes, suggests where each belongs based on your folder structure, and moves them with your approval.
Writing with context
"Draft a project update using my recent meeting notes"
Claude pulls relevant notes and uses them as source material.
Features
- Markdown notes with full formatting support
- Wiki-links (
[[id:Note Title]]) for cross-referencing - Folders with custom AI instructions per folder
- Full-text search across all content
- Bidirectional linking between notes
- Tags for cross-cutting categorization
- AI instructions at brain, folder, and team level
- Note history with per-revision attribution (you or which AI client) and revert
- Trash with 30-day restore for notes and folders
- File attachments on every plan (unlimited on Pro and Teams)
- Email capture: give a folder its own email address (Pro)
- Public sharing: publish a folder as a read-only page (Pro)
- Team collaboration with shared knowledge bases and per-folder roles
- iPhone, iPad, Mac & Android apps
- REST API for custom integrations
- Export your data as Markdown at any time
MCP server details
| Endpoint | https://hjarni.com/mcp |
| Transport | Streamable HTTP with JSON-RPC 2.0 |
| Protocol versions | 2025-11-25, 2025-06-18, 2025-03-26, and 2024-11-05 |
| Authentication | OAuth 2.0 (PKCE) or Bearer token |
| Capabilities | Tools, prompts, and UI resources (MCP Apps) |
For the full protocol reference, see the MCP server docs.
Pricing
| Plan | Price | What you get |
|---|---|---|
| Free | $0 | 25 notes, containers, tags, search, full MCP & API access, 20 MB across 5 file attachments |
| Pro | $12/mo or $120/yr | Unlimited notes and file attachments, email capture, public sharing, share with 2 collaborators |
| Teams | $20/seat/mo or $200/seat/yr | Shared knowledge base, team MCP & API, member management, per-folder roles |
Also available in EUR and GBP. See pricing.
Links
- Website
- Docs
- Getting started
- MCP server reference
- REST API reference
- Claude setup guide
- ChatGPT setup guide
- Blog
- Privacy
- Terms
Support
Email evert@hjarni.com.
Featured
Keeps your Mac awake while Claude Code, Codex or Cursor works. Lets it sleep when they are done.
Try free for 7 days →Block distracting apps from your iPhone permanently without a 3rd party app. Free and open source.
Block now (100% free) →Notes, actions and memory. Without a meeting bot. First month 100% off.
Download for free →belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →Free an open-source skills that make AI coding agents easier to understand, verify, and control.
Download for free →Connect your Claude agent to live crypto prices and trading routes via 1inch
Get the MCP →
