OpenKnowledge

Name: OpenKnowledge
Author: Inkeep

Lets an assistant search, write, edit and organise a local Markdown knowledge base

Official · Inkeep TypeScript Local · stdio Knowledge and memory Productivity Files and storage

GitHub npm Website

85 popularity score ★ 4.8k ↓ 15k/wk

Connect your client

Local (npm)

Add in one click

Add to Cursor Add to VS Code Add to LM Studio Add to Goose

Opens the app, which asks before it adds the server.

Or add it by command or config

Claude CodeTerminal

claude mcp add openknowledge -- npx -y @inkeep/open-knowledge mcp

Claude Desktopclaude_desktop_config.json

{
  "mcpServers": {
    "openknowledge": {
      "command": "npx",
      "args": [
        "-y",
        "@inkeep/open-knowledge",
        "mcp"
      ]
    }
  }
}

Cursor~/.cursor/mcp.json

{
  "mcpServers": {
    "openknowledge": {
      "command": "npx",
      "args": [
        "-y",
        "@inkeep/open-knowledge",
        "mcp"
      ]
    }
  }
}

VS Code.vscode/mcp.json

{
  "servers": {
    "openknowledge": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@inkeep/open-knowledge",
        "mcp"
      ]
    }
  }
}

Codex~/.codex/config.toml

[mcp_servers.openknowledge]
command = "npx"
args = ["-y", "@inkeep/open-knowledge", "mcp"]

Gemini CLITerminal

gemini mcp add --scope user openknowledge npx -- -y @inkeep/open-knowledge mcp

Settings 1

`OK_MCP_AUTOSTART`	Optional: Gate for auto-starting the OpenKnowledge (Hocuspocus) server on the first tool call that needs it.

What it does

OpenKnowledge is a local-first Markdown editor and knowledge base from Inkeep, available as a desktop app (macOS, Windows, Linux) and as a local web app and CLI installed from npm. It works on any folder of markdown or mdx files: codebases, wikis, Obsidian vaults, LLM wikis or plain notes, kept as plain files and version-controlled in git.

Alongside the editor it ships an MCP server and skills for agents. The MCP surface has 19 tools: a read-only shell over the workspace, ranked search, link views (backlinks, dead links, orphans), content linting and audits, version history, and tools to write, edit, move and delete documents, folders, templates, skills and assets. It can also save project-wide checkpoints, restore old versions, and find, import and install skills from skills.sh.

The Claude Code plugin starts it with npx @inkeep/open-knowledge@latest mcp; running ok init in a project wires it up for Claude Code, Claude Desktop, Cursor, Codex, OpenCode and OpenClaw. It needs Node.js 24+ and git. A running OpenKnowledge server can also be reached over Streamable HTTP at /mcp, for remote agents behind an authenticating proxy.

Tools 19

exec: Read-only shell (cat, ls, grep, find, head, tail, wc, sort, uniq, cut) over the workspace
search: Ranked workspace search; semantic search is opt-in
links: Link views: backlinks, forward, dead, orphans, hubs, suggest
lint: Report content-rule problems, optionally fixing them in place
audit: Read-only validation audit of content rules and broken links
history: Version timeline for a document, folder or skill
skills: Find skills on skills.sh, or list and read managed skills
config: Read the effective merged config
palette: Authoring forms, preview embed starters and theme tokens
preview_url: Resolve the browser-reachable preview URL
share_link: Build a GitHub share URL; never publishes
write: Create or overwrite a document, folder, template, skill or asset
edit: Modify a document, folder, template or skill by find/replace or frontmatter patch
delete: Delete a document, folder, template, skill or asset
move: Move or rename an item, optionally updating documents that link to it
install: Manage where a skill is available by placing copies or symlinks at editor locations
import: Import a skill from skills.sh, a GitHub repo, a git URL or a local path
checkpoint: Save a project-wide version snapshot
restore_version: Restore one document or skill to a historical version

Popularity

85 popularity score, on our list (the bar is 36)

★ 4.8k ↓ 15k/wk

GitHub stars, whole repository	4,807	33.4 points
Stars in 30 days	+385	10 points
npm downloads, last week	14,954	33.4 points
Official server	Yes	8 points

It lives in the folder packages/cli of inkeep/open-knowledge, which holds more than this server. Its stars are the whole repository's, so in the score they never count for more than its own downloads.

Measured 2026-11-07. How the score works.

Where it is published

Code	inkeep/open-knowledge/packages/cli ★ 4.8k, the whole repository
npm	@inkeep/open-knowledge 0.89.3, 2026-11-04

What it can reach

Runs	On your machine
Reaches	Files on your machine, The internet, Your code
Changes things	Yes: it can write, send, create or delete
Sign-in	None
Licence	GPL-3.0-or-later (npm)
Last code change	2026-11-04 (a release)

Runs on your machine through npx and works on a local project folder of markdown files. Write tools create, overwrite, edit, move and delete documents, folders, templates, skills and assets; an asset source is a local path the server reads. Writes that escape the content root or touch .git or config folders are refused. exec is a read-only shell limited to cat, ls, grep, find, head, tail, wc, sort, uniq and cut. Checkpoints and merges are committed to git; share_link never publishes. Network use: skill search and import from skills.sh and git URLs (imported scripts are not run), and opt-in semantic search sends content out. No sign-in locally; the HTTP server has no auth of its own, and the docs say to expose it only behind an authenticating proxy.

Over time

GitHub stars, whole repository 4.8k +385 (+9 %)

4.8k4.4k

8 Oct 20267 Nov 2026

npm downloads a week 15k +15k

34k0

4 May 20267 Nov 2026

Before the site measured it, read from npm's daily download counts.

Popularity score 85 +6 (+8 %)

8974

8 Oct 20267 Nov 2026

What is rising across the directory

Sources

Page checked 2026-10-13.

Badge for your README

Shows this server's rank in its category, and stars for a server that runs on your machine. It updates every hour.

MarkdownREADME.md

[![OpenKnowledge on EveryMCPServer](https://everymcpserver.com/badge/open-knowledge.svg)](https://everymcpserver.com/servers/open-knowledge)

Connect your client

Add in one click

Or add it by command or config

Settings 1

What it does

Tools 19

Similar servers

Hatchdoor

IWE

kordoc

Minutes

Obsidian MCP

MCP Local RAG