cairn-mcp-server

An MCP server that exposes Cairn's local-first file-organization tools to Claude Code, Codex, Cursor, and any MCP client. Point it at a folder and your agent gains file tools: list, read, search, grep, edit, move, tag, query, digest, and retrieve — over the .uni document format and plain markdown with YAML frontmatter.

This is the flagship, UI-less face of the product. The MCP client supplies the agent loop, the approval prompts, and the chat. Nothing of ours runs remotely; the server is a local process over your own files.

Install & run

uvx cairn-mcp-server --workspace ~/Documents/notes

To import real documents (docx/pdf/pptx/xlsx/md), install the converter extra:

uvx --with "cairn-core[convert]" cairn-mcp-server --workspace ~/Documents/notes

Use it in Claude Code

claude mcp add cairn -- uvx cairn-mcp-server --workspace ~/Documents/notes

Or in any MCP client config:

{
  "mcpServers": {
    "cairn": {
      "command": "uvx",
      "args": ["cairn-mcp-server", "--workspace", "~/Documents/notes"]
    }
  }
}

Tools

Read-only tools carry readOnlyHint; destructive tools carry destructiveHint, so clients like Claude Code run reads freely and prompt before destructive edits.

Also exposes workspace://tree and workspace://tags resources, and organize / tag_all prompts (slash-commands in the client).