# hjarni

Remote MCP server linking Markdown notes to your AI coding agent. It manages folders, tags, and long-term context without local containers.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: hjarni
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/hjarni/hjarni-mcp
- Updated: 2026-10-24
- HTML: https://affpapa.org/en/nevibecode/mcp/hjarni

## What it does

Hjarni links your Markdown knowledge base to coding agents via a hosted endpoint at `https://hjarni.com/mcp`. The service uses OAuth 2.0 with PKCE, so you skip API keys and local Docker setups.

The server supplies tools to query, update, and create notes, manage folder hierarchies, and inspect version history. It allows configuring custom instructions per folder and handling bidirectional note links.

Your client must support streaming HTTP transport to connect.

## Requirements
- Remote server: `https://hjarni.com/mcp`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http hjarni https://hjarni.com/mcp
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add hjarni --url https://hjarni.com/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "hjarni": {
            "url": "https://hjarni.com/mcp"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "hjarni": {
            "type": "http",
            "url": "https://hjarni.com/mcp"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http hjarni https://hjarni.com/mcp
```

## When to use it
- store project decisions directly into organized Markdown notes
- query prior context across folders using full-text search
- assign custom agent directives to designated folders
- restore earlier revisions of edited documents

## Example prompts
- Search my notes for previous decisions regarding the database schema.
- Save this discussion into my project folder and tag it with `backend`.
- Show the revision history for our deployment setup document.

## Similar
- [Reactive Resume](https://affpapa.org/en/nevibecode/mcp/reactive-resume.md) — MCP server · ★ 44908
- [screenpipe](https://affpapa.org/en/nevibecode/mcp/screenpipe.md) — MCP server · ★ 22082
- [Inbox Zero](https://affpapa.org/en/nevibecode/mcp/inbox-zero.md) — MCP server · ★ 12826
- [kaneo](https://affpapa.org/en/nevibecode/mcp/kaneo.md) — MCP server · ★ 9623
- [Mindwtr](https://affpapa.org/en/nevibecode/mcp/mindwtr.md) — MCP server · ★ 2330
- [Azure DevOps (ADO)](https://affpapa.org/en/nevibecode/mcp/azure-devops-ado.md) — MCP server · ★ 2071

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md