Nb MCP Server

MCP server wrapping the nb CLI for LLM-friendly note-taking

Local serverstdioPython

What is the Nb MCP server?

MCP server wrapping the nb CLI for LLM-friendly note-taking. That is what the nb mcp server brings to an AI assistant: the same capability, reachable through the Model Context Protocol rather than a separate app or dashboard.

Getting it running

Setup follows the usual MCP pattern — install or clone the server, register it in your client's configuration file, restart the client.

The tools it exposes

The server publishes 6 tools. What each one is for:

  • Prerequisites — Install nb by following the official instructions: nb installation guide
  • Installation — See the changelog for release history and upgrade notes
  • Notes — The Notes tool exposed by this server
  • Todos — The Todos tool exposed by this server
  • Organization — The Organization tool exposed by this server
  • Logging — Logs are written to ~/.local/state/nb-mcp/{project}--{worktree}.log (XDG-compliant)

What it needs from you

Install nb by following the official instructions: nb installation guide.

Things to watch

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • Keep per-call confirmation enabled while you learn its behaviour; it is the cheapest safeguard you have.

How it compares

Plenty of monitoring and observability servers cover similar ground. The differences that matter in practice are scope of access and how much setup stands between you and a working tool call. Nb's toolset — Prerequisites, Installation, Notes and 3 more — is a fair guide to whether it matches your workflow. It is maintained by emcd; worth a glance at recent repository activity before you build anything load-bearing on it.

SyncDev reviews every entry in this directory against the project's own documentation before publishing, and revisits them as servers change.

Available tools

ToolWhat it does
PrerequisitesInstall nb by following the official instructions: [nb installation guide](https://github.com/xwmx/nb#installation).
InstallationSee the [changelog](CHANGELOG.md) for release history and upgrade notes.
NotesThe Notes tool exposed by this server.
TodosThe Todos tool exposed by this server.
OrganizationThe Organization tool exposed by this server.
LoggingLogs are written to ~/.local/state/nb-mcp/{project}--{worktree}.log (XDG-compliant).

Configuration

Install nb by following the official instructions: nb installation guide.

Example prompts to try

  • Use Nb to Prerequisites.
  • Use Nb to Installation.
  • Use Nb to Notes.

Frequently asked questions

It connects Nb to MCP-compatible AI assistants such as Claude and Cursor, exposing 6 tools (Prerequisites, Installation, Notes, and more) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with Nb directly.