AI Developer Documentation

Connect MCP clients, skills, and local agents

Knight Note can act as a local AI memory vault for Claude Code, Claude Desktop, Cursor, OpenAI Codex, Gemini CLI, OpenCode, and other MCP-compatible tools. The app exposes an Obsidian-readable Markdown mirror for agent context while keeping JSON as the canonical sync-safe source of truth.

1. Prepare the vault

Create an AI Memory vault during onboarding, or open Settings > AI Search and enable the AI Markdown Mirror for an existing vault. AI Memory vaults enable the mirror automatically.

  • Mirror folder: `AI Markdown Mirror/` inside the vault folder.
  • MCP map: `.knightnote/ai-map.json` inside the vault folder.
  • Canonical data: `note_*.json`, `folders.json`, `vault.json`, and `.knightnote/` metadata.

2. Pick a permission preset

Read-only

Search and read memory. No JSON writes.

Append-only

Append to existing notes or daily notes only.

No destructive tools

Create, organize, and tag notes, but no soft delete.

Full read/write

All JSON-aware write tools, including soft delete.

3. Commands from Knight Note settings

Settings > AI Search generates exact commands for your installed app path and vault path. The examples below use placeholders. Replace them with the copied values from the app.

Selected preset MCP command

"C:\Path\To\Knight Note.exe" --knightnote-mcp "C:\Users\you\Knight Note Vaults\ai_vault" --knightnote-mcp-preset "full-write"

Legacy full-write MCP command

"C:\Path\To\Knight Note.exe" --knightnote-mcp "C:\Users\you\Knight Note Vaults\ai_vault" --knightnote-mcp-write

Full read/write Claude Desktop JSON

Paste into a Claude Desktop MCP server configuration.

{
  "mcpServers": {
    "knight-note-full-write": {
      "command": "C:\\Path\\To\\Knight Note.exe",
      "args": [
        "--knightnote-mcp",
        "C:\\Users\\you\\Knight Note Vaults\\ai_vault",
        "--knightnote-mcp-preset",
        "full-write"
      ]
    }
  }
}

Full read/write Cursor, Codex, Gemini, and OpenCode JSON

Use in MCP clients that accept an `mcpServers` JSON block.

{
  "mcpServers": {
    "knight-note-full-write": {
      "command": "C:\\Path\\To\\Knight Note.exe",
      "args": [
        "--knightnote-mcp",
        "C:\\Users\\you\\Knight Note Vaults\\ai_vault",
        "--knightnote-mcp-preset",
        "full-write"
      ]
    }
  }
}

Full read/write Claude Code command

Use with Claude Code installations that support adding a local stdio MCP server from the terminal.

claude mcp add knight-note-full-write -- "C:\Path\To\Knight Note.exe" --knightnote-mcp "C:\Users\you\Knight Note Vaults\ai_vault" --knightnote-mcp-preset "full-write"

Full read/write stdio command

Use when an MCP client asks for a direct local stdio command.

"C:\Path\To\Knight Note.exe" --knightnote-mcp "C:\Users\you\Knight Note Vaults\ai_vault" --knightnote-mcp-preset "full-write"

Writable Claude Desktop JSON

Legacy writable mode. Prefer preset commands for day-to-day agent memory.

{
  "mcpServers": {
    "knight-note-write": {
      "command": "C:\\Path\\To\\Knight Note.exe",
      "args": [
        "--knightnote-mcp",
        "C:\\Users\\you\\Knight Note Vaults\\ai_vault",
        "--knightnote-mcp-write"
      ]
    }
  }
}

Writable Cursor, Codex, Gemini, and OpenCode JSON

Use in MCP clients that accept an `mcpServers` JSON block.

{
  "mcpServers": {
    "knight-note-write": {
      "command": "C:\\Path\\To\\Knight Note.exe",
      "args": [
        "--knightnote-mcp",
        "C:\\Users\\you\\Knight Note Vaults\\ai_vault",
        "--knightnote-mcp-write"
      ]
    }
  }
}

Writable Claude Code command

claude mcp add knight-note-write -- "C:\Path\To\Knight Note.exe" --knightnote-mcp "C:\Users\you\Knight Note Vaults\ai_vault" --knightnote-mcp-write

Writable stdio command

"C:\Path\To\Knight Note.exe" --knightnote-mcp "C:\Users\you\Knight Note Vaults\ai_vault" --knightnote-mcp-write

4. Skill and agent guidance

  • Start read-only for research, summarization, and memory recall.
  • Use append-only for durable memory capture and daily-note workflows.
  • Use dry-run before create, append, metadata, folder, wiki-link, delete, or restore operations.
  • Ask agents to cite note titles or mirror paths when answering from memory.
  • Never edit `note_*.json`, `folders.json`, `vault.json`, or `.knightnote/` directly from an agent.