Nb Mcp Server
Let your coding agent search, add, and organize local notes through the nb CLI without leaving the chat.
Overview
nb-mcp-server is an MCP server for the Build phase that wraps the nb CLI so agents can manage local notes programmatically.
What is this MCP server?
- Stdio MCP server (v0.9.0) wrapping the nb note-taking CLI for LLM-friendly operations
- Ships as MCPB bundles for macOS aarch64, Linux gnu, and Windows x86_64
- Keeps notes in your existing nb vault instead of a proprietary cloud notebook
- Fits daily dev logs, spec snippets, and task lists the agent can query by keyword
- Complements local-first workflows where the repo and notes stay on your machine
- Server version 0.9.0
- Transport: stdio
- Three published MCPB platform targets (aarch64-apple-darwin, aarch64-unknown-linux-gnu, x86_64-pc-windows-msvc)
Community signal: 1 GitHub stars.
What problem does it solve?
Context about past decisions lives in a separate notes app the agent cannot see unless you paste chunks into every thread.
Who is it for?
Solo builders already using nb who want Claude Code or Cursor to read and write project notes over MCP stdio.
Skip if: Teams that need a hosted Notion-style wiki, rich UI editing, or notes with no local nb installation.
What do I get? / Deliverables
After you register the server, your agent can query and update nb notebooks on your machine during implementation and review work.
- Registered stdio MCP server entry in your agent config
- Agent-callable nb operations against your local notebook store
- Repeatable note workflows without leaving the coding session
Recommended MCP Servers
Journey fit
Note capture and retrieval sit in Build because solo builders wire agent tooling first, then reuse notes across later phases. Agent-tooling is the canonical shelf for MCP bridges that expose a CLI workflow to Claude Code, Cursor, and similar clients.
How it compares
MCP integration around the nb CLI, not a standalone brainstorming or planning skill.
Common Questions / FAQ
Who is Nb Mcp Server for?
It is for indie developers and agent users who keep project knowledge in nb and want their coding assistant to access that vault through MCP.
When should I use Nb Mcp Server?
Use it while building or iterating when you want the agent to log findings, recall prior specs, or append tasks without manual copy-paste from a notes terminal.
How do I add Nb Mcp Server to my agent?
Install nb locally, download the matching v0.9.0 MCPB release for your OS, and register the stdio server in your MCP client configuration pointing at that bundle.