# Docs Hjarni is a Markdown-based knowledge base with a built-in MCP server. These docs cover setup, concepts, and integrations. [Getting started](https://hjarni.com/docs/getting-started) Understand the model, create your first structure, connect an AI, and avoid common setup mistakes. ## Reading paths New user - [Getting started](https://hjarni.com/docs/getting-started) - [Set up by talking to your LLM](https://hjarni.com/docs/use-with-your-llm) - [Notes in Markdown](https://hjarni.com/docs/notes) - [Containers and tags](https://hjarni.com/docs/containers-and-tags) - [Custom AI instructions](https://hjarni.com/docs/ai-instructions) AI user - [Use Hjarni with ChatGPT](https://hjarni.com/docs/chatgpt) - [Use Hjarni with Claude](https://hjarni.com/docs/claude) - [Use Hjarni with OpenClaw](https://hjarni.com/docs/openclaw) - [Privacy, permissions, and AI boundaries](https://hjarni.com/docs/privacy-and-permissions) Developer - [What is MCP?](https://hjarni.com/docs/what-is-mcp) - [MCP vs API](https://hjarni.com/docs/mcp-vs-api) - [MCP vs Custom GPTs](https://hjarni.com/docs/mcp-vs-custom-gpts) - [REST API reference](https://hjarni.com/docs/api) - [MCP reference](https://hjarni.com/docs/mcp) - [Auto-capture Claude Code sessions](https://hjarni.com/docs/claude-code-hooks) - [Auto-capture Codex CLI sessions](https://hjarni.com/docs/codex-hooks) - [Export and data ownership](https://hjarni.com/docs/export-and-ownership) - [Import from Obsidian or Markdown](https://hjarni.com/docs/import) Team admin - [Teams and sharing](https://hjarni.com/docs/teams-and-sharing) - [Share a folder publicly](https://hjarni.com/docs/public-sharing) - [Custom AI instructions](https://hjarni.com/docs/ai-instructions) - [Privacy, permissions, and AI boundaries](https://hjarni.com/docs/privacy-and-permissions) - [Export and data ownership](https://hjarni.com/docs/export-and-ownership) - [Import from Obsidian or Markdown](https://hjarni.com/docs/import) ## Connect your AI [Set up Hjarni by talking to your LLM](https://hjarni.com/docs/use-with-your-llm) Paste one URL into ChatGPT or Claude and let your AI handle the MCP connection, the folder structure, and the first notes. [Use Hjarni with ChatGPT](https://hjarni.com/docs/chatgpt) Set up Hjarni as a connector in ChatGPT and verify the connection. [Use Hjarni with Claude](https://hjarni.com/docs/claude) Connect via Claude.ai, Claude iOS, Claude Desktop, or Claude Code. [Auto-capture Claude Code sessions](https://hjarni.com/docs/claude-code-hooks) Wire a Claude Code Stop hook to the Hjarni API so every session becomes a note. [Auto-capture Codex CLI sessions](https://hjarni.com/docs/codex-hooks) Same pattern for Codex: a Stop hook writes every session to Hjarni as a growing note. [Use Hjarni with OpenClaw](https://hjarni.com/docs/openclaw) Give your OpenClaw agent access to your notes via MCP. [Use Hjarni with Zapier](https://hjarni.com/docs/zapier) Automate note creation from 9,000+ apps through Zapier. ## Hjarni for your AI tool Short landing pages with the exact MCP config for each client. See the [compatibility matrix](https://hjarni.com/compatibility) for every client at a glance. - [Claude](https://hjarni.com/for/claude) - [ChatGPT](https://hjarni.com/for/chatgpt) - [Cursor](https://hjarni.com/for/cursor) - [Claude Code](https://hjarni.com/for/claude-code) - [Windsurf](https://hjarni.com/for/windsurf) - [Cline](https://hjarni.com/for/cline) - [GitHub Copilot](https://hjarni.com/for/copilot) - [Zed](https://hjarni.com/for/zed) - [Continue.dev](https://hjarni.com/for/continue-dev) - [Aider](https://hjarni.com/for/aider) - [Goose](https://hjarni.com/for/goose) - [Open WebUI](https://hjarni.com/for/openwebui) - [Raycast](https://hjarni.com/for/raycast) - [Alfred](https://hjarni.com/for/alfred) - [Obsidian](https://hjarni.com/for/obsidian) - [Gemini CLI](https://hjarni.com/for/gemini-cli) - [Perplexity](https://hjarni.com/for/perplexity) - [Junie](https://hjarni.com/for/junie) - [LibreChat](https://hjarni.com/for/librechat) - [Jan](https://hjarni.com/for/jan) - [LM Studio](https://hjarni.com/for/lm-studio) - [n8n](https://hjarni.com/for/n8n) ## Product concepts [Notes in Markdown](https://hjarni.com/docs/notes) The storage model: body, summary, source URL, tags, links, files, and version history. [Note history and Trash](https://hjarni.com/docs/note-history) Versioned edits with provenance (you vs your AI), view and revert to any earlier version, and a recoverable 30-day Trash. [File attachments](https://hjarni.com/docs/file-attachments) Attach PDFs, images, and other files to a note so your AI can read them too. Free includes 20 MB across five personal files. [Email notes into Hjarni](https://hjarni.com/docs/email-capture) Give a folder its own email address. Anything you send or forward to it becomes a note, subject as the title and attachments included. [Containers and tags](https://hjarni.com/docs/containers-and-tags) Use containers for structure and tags for cross-cutting labels. [Wiki-links between notes](https://hjarni.com/docs/wiki-links) Bidirectional links so your AI can follow relationships, not just folders. [Custom AI instructions](https://hjarni.com/docs/ai-instructions) Set global, personal, container, or team rules for how assistants should work. [Templates](https://hjarni.com/docs/templates) Bootstrap a workspace structure through your connected assistant. ## Teams and trust [Teams and sharing](https://hjarni.com/docs/teams-and-sharing) Team spaces, collaborators, and who can access what. [Set up your team](https://hjarni.com/docs/set-up-a-team) Create a team, structure shared folders, set team-level AI instructions, and invite your teammates. A step-by-step first-day setup. [Team billing and seats](https://hjarni.com/docs/team-billing) How team pricing works: free to start, then per seat. What a seat includes, when seats bill, and how to manage them. [Single sign-on (Enterprise)](https://hjarni.com/docs/sso) SAML 2.0 for login, SCIM 2.0 for provisioning. Works with Okta, Microsoft Entra, Auth0, and any SAML IdP. [Share a folder or note publicly](https://hjarni.com/docs/public-sharing) Turn any folder or single note into a public page, view-only or editable by anyone with the link. [Team audit log (Enterprise)](https://hjarni.com/docs/audit-log) Per-team log of every view, edit, and access change across web, API, MCP, and public links. Available on request. [Two-factor authentication](https://hjarni.com/docs/two-factor-authentication) Ask for a code from an authenticator app every time you sign in, with ten recovery codes for a lost phone. On every plan. [Passkeys](https://hjarni.com/docs/passkeys) Sign in with Face ID, Touch ID, a fingerprint or your device PIN. Bound to hjarni.com, and no two-factor code on top. On every plan. [Privacy, permissions, and AI boundaries](https://hjarni.com/docs/privacy-and-permissions) What Hjarni does, what ChatGPT or Claude does, and what a connection grants. [Export and data ownership](https://hjarni.com/docs/export-and-ownership) What you can export, what format it uses, and what stays portable. [Import from Obsidian or Markdown](https://hjarni.com/docs/import) Bring your vault in with folders, wiki-links, and attachments intact. [Open Knowledge Format (OKF)](https://hjarni.com/docs/open-knowledge-format) Export your knowledge as an OKF bundle: Markdown, YAML front-matter, folders, links, and a change log any AI agent can read. How OKF maps to Hjarni. ## MCP and integrations [What is MCP?](https://hjarni.com/docs/what-is-mcp) Model Context Protocol explained: what it is, how it works, who supports it. [MCP vs API](https://hjarni.com/docs/mcp-vs-api) APIs are for your code. MCP is for your AI. When to use each. [MCP vs Custom GPTs](https://hjarni.com/docs/mcp-vs-custom-gpts) Uploaded files go stale. MCP gives your AI a live connection to the source. [Connect any MCP server to ChatGPT](https://hjarni.com/docs/connect-chatgpt-mcp) General guide for adding any MCP server to ChatGPT. [Connect any MCP server to Claude](https://hjarni.com/docs/connect-claude-mcp) General guide for adding any MCP server to Claude.ai, Desktop, or Code. [Connect GitHub Copilot to MCP](https://hjarni.com/docs/connect-copilot-mcp) Add an MCP server to Copilot Chat in VS Code via mcp.json. Mind the servers key. [Connect Copilot Studio to MCP](https://hjarni.com/docs/connect-copilot-studio-mcp) Add a server to a Microsoft Copilot Studio agent through the MCP onboarding wizard, plus the streaming-timeout fixes. [Connect Perplexity to MCP](https://hjarni.com/docs/connect-perplexity-mcp) Add a custom MCP connector so Perplexity can read your own notes. [Connect Cursor to MCP](https://hjarni.com/docs/connect-cursor-mcp) Add any MCP server to Cursor via mcp.json, global or per-project, with OAuth on first run. [Connect Raycast to MCP](https://hjarni.com/docs/connect-raycast-mcp) Install an MCP server in Raycast AI and ask your own notes from anywhere on the desktop. [MCP reference](https://hjarni.com/docs/mcp) Transport, OAuth, tools, prompts, limits, and troubleshooting. [REST API reference](https://hjarni.com/docs/api) Authentication, pagination, endpoints, request shapes, and response examples. [MCP Config Validator](https://hjarni.com/mcp-config-validator) Paste a claude_desktop_config.json and catch JSON errors, missing fields, and typos in your browser. [MCP fixes](https://hjarni.com/mcp-fix) The configuration errors that show up the first time you wire an MCP server into Cursor, Claude Desktop, Claude Code, ChatGPT, or VS Code. Each page is a focused, copy-paste fix. ## Conceptual background [AI Glossary](https://hjarni.com/docs/glossary) Plain-language definitions for MCP, RAG, AI agents, second brains, and the terms that show up around them. [What is a second brain?](https://hjarni.com/docs/what-is-a-second-brain) The concept, how AI changes it, and what to look for in a second brain app. [What is RAG?](https://hjarni.com/docs/what-is-rag) Retrieval-Augmented Generation: how AI models look up your data before they answer, and where MCP fits. [What is an AI agent?](https://hjarni.com/docs/what-is-an-ai-agent) Models that pick tools, call them, and run in a loop. How agents differ from chatbots, and how memory keeps them useful between runs. [How to give your AI long-term memory](https://hjarni.com/docs/ai-long-term-memory) Stop re-explaining yourself. Connect your AI to an external knowledge base. Can't find what you need? Email [evert@hjarni.com](mailto:evert@hjarni.com) and we'll help.