nb-mcp-server
Wraps the nb CLI to give Claude proper note-taking capabilities without shell escaping headaches. Exposes operations for creating, editing, searching, and organizing Markdown notes, todos, and bookmarks through JSON parameters instead of raw shell commands. Handles notebook context explicitly so you can maintain separate note collections per project. Commands include nb.add for new notes with tags and folders, nb.search for full-text queries, nb.todo for task management, and nb.move for reorganization. Automatically creates notebooks and manages Git commits in the background. Particularly helpful if you're coordinating multiple LLMs on the same codebase and need structured, searchable notes that survive backticks and code blocks. Requires nb installed locally and supports configuration via environment variables or CLI flags.
- tools
- 24
- transport
- STDIO
- last updated
- Nov 10, 2026
Tools
24 toolsPublic tool metadata for what this MCP can expose to an agent.
nbMultiplexed tool wrapping all nb commands via a command parameter; the canonical access path.
Multiplexed tool wrapping all nb commands via a command parameter; the canonical access path.
No parameter schema in public metadata yet.
addDirect first-class tool for creating a note with a typed schema.
Direct first-class tool for creating a note with a typed schema.
No parameter schema in public metadata yet.
showDirect first-class tool for reading a note.
Direct first-class tool for reading a note.
No parameter schema in public metadata yet.
deleteDirect first-class tool for deleting a note.
Direct first-class tool for deleting a note.
No parameter schema in public metadata yet.
moveDirect first-class tool for moving or renaming a note.
Direct first-class tool for moving or renaming a note.
No parameter schema in public metadata yet.
listDirect first-class tool for listing notes.
Direct first-class tool for listing notes.
No parameter schema in public metadata yet.
searchDirect first-class tool for full-text search.
Direct first-class tool for full-text search.
No parameter schema in public metadata yet.
todoDirect first-class tool for creating a todo.
Direct first-class tool for creating a todo.
No parameter schema in public metadata yet.
doDirect first-class tool for marking a todo complete.
Direct first-class tool for marking a todo complete.
No parameter schema in public metadata yet.
undoDirect first-class tool for reopening a todo.
Direct first-class tool for reopening a todo.
No parameter schema in public metadata yet.
tasksDirect first-class tool for listing todos.
Direct first-class tool for listing todos.
No parameter schema in public metadata yet.
bookmarkDirect first-class tool for saving a URL.
Direct first-class tool for saving a URL.
No parameter schema in public metadata yet.
foldersDirect first-class tool for listing folders.
Direct first-class tool for listing folders.
No parameter schema in public metadata yet.
mkdirDirect first-class tool for creating a folder.
Direct first-class tool for creating a folder.
No parameter schema in public metadata yet.
importDirect first-class tool for importing a file or URL.
Direct first-class tool for importing a file or URL.
No parameter schema in public metadata yet.
statusDirect first-class tool for notebook info.
Direct first-class tool for notebook info.
No parameter schema in public metadata yet.
notebooksDirect first-class tool for listing notebooks.
Direct first-class tool for listing notebooks.
No parameter schema in public metadata yet.
replace_note_bodyBody-aware tool for replacing a note's body.
Body-aware tool for replacing a note's body.
No parameter schema in public metadata yet.
edit_note_substringBody-aware tool for editing a substring of a note.
Body-aware tool for editing a substring of a note.
No parameter schema in public metadata yet.
edit_note_linesBody-aware tool for editing lines of a note.
Body-aware tool for editing lines of a note.
No parameter schema in public metadata yet.
retitle_noteBody-aware tool for changing a note's title.
Body-aware tool for changing a note's title.
No parameter schema in public metadata yet.
edit_note_tagsBody-aware tool for editing a note's tags.
Body-aware tool for editing a note's tags.
No parameter schema in public metadata yet.
show_note_linesLine tool for showing note lines.
Line tool for showing note lines.
No parameter schema in public metadata yet.
search_note_linesLine tool for searching note lines.
Line tool for searching note lines.
No parameter schema in public metadata yet.
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageReadme
nb-mcp
MCP server wrapping the nb CLI for LLM-friendly note-taking.
Motivation
Using nb directly via shell has two problems for LLM assistants:
-
Backtick escaping: Markdown content with backticks triggers shell command substitution, corrupting notes.
-
Notebook context:
nbassumes a default notebook, making per-project use awkward.
This MCP server solves both by:
- Accepting content as JSON parameters (no shell escaping needed)
- Qualifying all commands with an explicit notebook
Quick Start
Prerequisites
Install nb by following the official instructions:
nb installation guide.
Installation
From crates.io:
cargo install nb-mcp-server
See the changelog for release history and upgrade notes.
Or download a prebuilt binary from GitHub Releases.
Build from Source
cargo build --release
Run
With default notebook from environment:
NB_MCP_NOTEBOOK=myproject ./target/release/nb-mcp
Details
- Repository
- github.com/emcd/nb-mcp-server
- Categories
- AI & LLM Tools, Documents & Knowledge
- Package
https://github.com/emcd/nb-mcp-server/releases/download/v0.16.0/nb-mcp-server-0.16.0-aarch64-apple-darwin.mcpb- Transport
- STDIO
- Registry
- MCP registry, active
Related AI & LLM Tools MCP servers
View all
A2CRa2cr/a2crSave AI-agent handoff checkpoints, WorkStash notes, and WorkThreads in a local A2CR workspace.2stars
second-brain MCPddmanyes/second-brain-mcpSelf-maintaining knowledge vault: figure-level search, auto-wikilinks, and memory compression.2stars
Youtube Video Analyzerludmila-omlopes/youtube-video-analyzer-mcpMCP stdio server for analyzing YouTube videos with Google Gemini2stars
Sentinal Mcpmusaraf-m/sentinalRedis health, BullMQ queue monitoring, memory analysis, and slow query diagnostics2stars
Kernal Mcppintomatic/kernalGraph-native memory for AI agents: a knowledge graph built from conversation, via MCP.2stars
Sprintrasprintra-io/sprintra-mcpThe project brain for AI coding agents — memory, decisions, sprints, knowledge base via MCP.2stars