Hjarni

Hjarni includes a built-in MCP server for ChatGPT, Claude, and other compatible clients. Use this page as the protocol and capability reference. If you just want to connect an assistant, start withChatGPT setuporClaude setup.

POST /mcp # JSON-RPC requests GET /mcp # not supported for streaming DELETE /mcp # not supported for termination

{ "mcpServers": { "hjarni": { "url": "https://hjarni.com/mcp", "headers": { "Authorization": "Bearer YOUR_API_TOKEN" } } } }

- Instruction levels arebrain,personal_root,container, andteam.
- For search, usesearch_scopeto distinguish personal notes, all accessible notes, or a specific team.
- For note links in bodies, the robust form is[[id:Note Title]].
- For file uploads, preferfiles-create_upload_urlover sending base64 directly.

The server also exposes MCP prompts. These are useful for clients that support prompt discovery.

Summarize a note and suggest tags and related links. Requiresnote_id.

Review recent activity and suggest organization improvements. Optionaldays.

Synthesize everything in the knowledge base related to a topic. Requirestopic.

- MCP uses the access rights of the connected Hjarni account.
- Team notes are accessible if the user belongs to the team.
- Shared containers are visible in MCP results when the user has access.
- Some actions remain owner-only for shared personal containers.
- Free accounts can use file tools for up to 20 MB across five personal attachments. Team/shared attachments and additional capacity require a paid plan.
- Rate limits: 60 requests per minute per token on/mcp, 20 team invites per team per hour, and 10 OAuth client registrations per IP per hour. Exceeding one returns429.

The token is invalid, expired, or missing. Re-authorize the OAuth client or generate a new token inSettings > Connections.

The client is sending an unrecognizedOriginheader. Hjarni currently allows its own host, localhost, and Claude/Anthropic origins (claude.ai,claude.com,*.anthropic.com). Custom clients should avoid unexpected browser origins.

API tokens limited to one folder cannot be used with MCP: every call fails with "This API token is scoped to a folder and cannot be used with the MCP server." Use a full-access token (or the OAuth flow), or call the REST API at/api/v1with the scoped token.

More than 60 requests in a minute on one token. Back off and retry; the response includes aRetry-Afterheader.

Use MCP JSON-RPC methods liketools/listandtools/call. Do not treat/mcpas a generic REST endpoint.

Make sure the client successfully calledinitializeand thentools/list. If not, the connection likely failed before the MCP session was established.

Check themeresponse for remaining file storage and count. Preferfiles-create_upload_urlinstead of base64 for anything non-trivial.

Emailevert@hjarni.comand we'll help debug the connection.

Connect Claude or ChatGPT to notes they can actually read and write.

Create notes, search, & think with your Fabric AI workspace

A backend server for the Notemd Obsidian plugin, offering AI-powered text processing and knowledge management.

Centralized note store across AI clients: Claude, ChatGPT, Cursor, Codex, Windsurf. Save in one client, access in another instantly. Across devices — phone, desktop, everywhere. Cross-session context: 'catch me up' surfaces plans and findings from any prior session. AES-256-GCM encryption at rest, per-user key isolation. Soft delete with 30-day recovery window. Pin notes to exempt from cleanup and prioritize. Tag notes for categorization and filtering ('tag: auth'). Your mctx account is your identity — instant access from any AI tool.

An Obsidian plugin that embeds an MCP server to interact with your notes using AI.

Let AI read, search, and summarize your UpNote notes — and create new ones — right from your chat.

Prompt Buddy MCP exposes a public, searchable catalog of reusable AI skills.

Portable, cloud-hosted AI memory you own - structured memories, tasks, goals, and notes that work across Claude, ChatGPT, Gemini, and any MCP client.

Interact with your Anytype data through its API, enabling AI assistants to access your information.

MCP server for Apple Notes with semantic search and CRUD operations. Claude searches, reads, creates, updates, and manages your Apple Notes through natural language.