Saved work
By default, the state folder is
~/.local/state/knowledge-mcp.
To pick up later, start a new chat in the same folder. Ask your assistant to reload your document settings, reopen your review note and check which files changed since last time. That only works if a file list was saved in an earlier session. Nothing watches your files in the background.
Recovery
- If an edit goes wrong or gets interrupted, stop making changes.
- Ask your assistant: “Compare my files with the saved history.”
- Then ask: “What changed, and what can you restore?”
- Review its proposal before you approve the restore. Make sure it keeps any edits made after the one you’re undoing.
Data and removal
The knowledge-mcp server doesn’t make network calls or open a network port. Text that knowledge-mcp gives your assistant is handled by your AI app and model under their own policies. Saved answers and edit history can contain sensitive text, and the logs aren’t cleared automatically. To remove knowledge-mcp:1
Quit your AI apps
Close Claude Code, Codex or any other app you set up with knowledge-mcp.
2
Disconnect knowledge-mcp from each app
Run the setup command you used again with The command tells you if anything in that app’s settings is left for you to remove.
--remove:3
Uninstall knowledge-mcp
Uninstalling leaves your documents, document settings and history in place. If you plan to delete them, copy your edit history first.
Troubleshooting
If you can reproduce a problem, report it on GitHub Issues. Include your knowledge-mcp version, the AI app you use, the
kb doctor result and the steps to reproduce it. Leave out document text and sensitive logs.
Report security issues through a private security advisory, with the affected version, the steps to reproduce and the impact. Only the latest release gets security fixes.
FAQ
What carries over between chats?
What carries over between chats?
Your document settings, filing rules, tool answers and recorded edits carry over. Your assistant shows a document’s latest edit when you return to it. Save anything unfinished in a note.
Which drives and bases are supported?
Which drives and bases are supported?
Knowledge-MCP supports any drive, network storage, or knowledge base that can hold a
.knowledge-bus folder for your knowledge specs, file management rules, and settings. The only prerequisite is that your agent or harness can access that configuration folder.Which apps can I connect?
Which apps can I connect?
You can connect Claude Code, Codex, Claude Desktop, Pi and OpenCode with
kb setup. Claude Code and Codex can also use the plugin.Does knowledge-mcp block unapproved edits?
Does knowledge-mcp block unapproved edits?
No. It’s up to your assistant to ask before it edits.