Inkra MCP Server

Drive a native macOS Markdown editor from Claude, Cursor, or any MCP client.

This is the official Model Context Protocol bridge for Inkra — a native macOS Markdown editor (SwiftUI + AppKit, not Electron) with live KaTeX/Mermaid preview and a built-in AI assistant.

> You need the Inkra app installed and running. This MCP server is a stdio→HTTP bridge — Inkra owns the document state, undo stack, syntax highlighting, and rendering. Get Inkra at store.juergenkoller.software/apps/inkra.

---

What you can do

> "Claude, open ~/Notes/2026-thesis.md, find every heading that contains 'TODO', add a checkbox after it, and save."
>
> "Cursor, list all files in the current folder, bookmark the H2 'Methodology', and switch to Focus Mode."

The MCP server exposes 18 tools across these categories:

| Category | Tools |
|---|---|
| Document content | document_get_content, document_set_content, document_insert, document_replace, document_search |
| Document lifecycle | document_open, document_create, document_save |
| Navigation | outline_get, bookmarks_list, bookmark_add, bookmark_remove |
| Folder / files | folder_open, folder_list_files |
| Metadata | frontmatter_get (YAML front-matter parser) |
| View | theme_set (standard / sepia / night), view_mode_set (focus / wide) |
| State | window_info |

Every tool operates on the currently open document in the Inkra app — so AI agents see exactly what you see, edits show up live with syntax highlighting and preview, and undo/redo work in the app's normal undo stack.

---

Installation

Prerequisites

1. macOS 14 (Sonoma) or later
2. Inkra app installed and running — get it here (free during beta, available on Mac App Store and direct download)
3. Swift 5.9+ (Xcode 15+) if building from source

Build from source

```bash
git clone https://github.com/juergenkoller-software/inkra-mcp.git
cd inkra-mcp
swift build -c release