Noesis keeps your knowledge in plain .md files and exposes them to Claude Code through a first-party MCP server — so you can search, read, write, and sync your notes from the terminal. Your whole second brain becomes context for every prompt. Think of Noesis as a Claude Code md manager: a home for your .md files that Claude Code can read, write, search, and sync on demand.
CLAUDE.mdCLAUDE.md is great for project instructions Claude Code loads every session. Noesis handles the other half: the growing body of knowledge — research, decisions, snippets, things you learned — that's too big to paste into a config file. Those stay as ordinary markdown notes, and the MCP server lets Claude Code pull exactly the right one on demand instead of you copy-pasting it in. Both speak plain markdown; nothing is locked in.
Is Noesis a “Claude Code md manager”? If you mean a manager for the markdown (.md) notes Claude Code works with — yes, that's exactly what Noesis is. If you mean a tool for editing your CLAUDE.md config file, that's a different job, and Anthropic's own CLAUDE.md tooling already owns it. Noesis manages your knowledge .md files, not your config.
strong· partial / depends· not built in
Honest concessions: if your notes already live in the repo Claude Code is working in, plain files need zero setup and no server. Noesis earns its keep once you have more notes than you can grep, want them on your phone, or want semantic search and sync. Keep both — Noesis reads and writes the same files.
Noesis ships a first-party @noesis-brain/mcp-server on npm so Claude Code can read, write, search, and sync your markdown notes directly from the terminal. 19 tools cover semantic search, embeddings, conflict-aware 3-way merge for offline sync, AI metadata enhancement, and related-note discovery. Plug it into Claude Code in two lines of config and your notes become a first-class context source for every prompt.
Claude Code: the easiest way
Run this one command in a terminal. You do not need to edit any file.
claude mcp add noesis --scope user -e NOESIS_API_TOKEN="<your token>" -e NOESIS_API_URL="https://noesisbrain.com" -- npx -y @noesis-brain/mcp-serverThen restart Claude Code, or run /mcp inside it.
Claude Code: by hand
Open this file:
~/.claude.jsonPaste the block inside the top-level "mcpServers" object.
Quit Claude Code first. It rewrites this file while it runs, so it can undo your edit.
The Claude Desktop app
In the app, choose Settings -> Developer -> Edit Config. This opens the right file for you.
The file is here:
~/Library/Application Support/Claude/claude_desktop_config.jsonPaste the block inside "mcpServers", then quit and reopen the app.
Open the folder in Finder (macOS)
In Finder, press Cmd+Shift+G, type one of these folders, and press Return:
~~/Library/Application Support/Claude.claude.json is a hidden file. Press Cmd+Shift+. in Finder to show hidden files.
Edit the file in a code editor, such as VS Code. TextEdit and Notepad can turn straight quotes into curly quotes, and curly quotes break the JSON.
Your .md files import as-is and export as-is. Point Noesis at a folder, use it from Claude Code, and if it doesn't click your files are exactly where you left them — plain markdown, no proprietary format.