juergenkoller-software/inkra-mcp

**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
Pre-built binary
See Releases.
---
Configuration
Claude Desktop
Get INKRA_TOKEN from **Inkra → Settings → API & Integrations**.
Claude Code
Cursor / other MCP clients
Same pattern — stdio MCP server, two env vars.
---
How it works
The bridge forwards JSON-RPC over stdio to Inkra's local HTTP MCP endpoint. The app handles document state (NSTextView with TextKit 2), AST-based syntax highlighting, KaTeX/Mermaid live preview, undo/redo, session restore, and exports.
---
Environment variables
| Variable | Default | Description |
|---|---|---|
| INKRA_PORT | 22300 | Port of Inkra's local HTTP server |
| INKRA_TOKEN | _(none)_ | Bearer token from Inkra Settings (required) |
---
About Inkra
Inkra is a native macOS Markdown editor — **not** an Electron app. Highlights:
- **Native** — SwiftUI + AppKit, real macOS performance