SkillFoxx

silverbullet-ai-mcp

silverbullet-ai-mcp exposes the silverbullet-ai plug tools in a SilverBullet notes space to MCP clients.

  • 109 ★ on the repository
  • Last commit
  • AGPL-3.0
MCP serverOfficial

Extended access

Why this level

  • Plug tools create and change notes; the built-in tool list includes Lua execution.
All reasons and checks

justyns/silverbullet-aiAuthor:justyns

Install

In your terminal, with SkillFoxx CLI

npx skillfoxx add mcp/silverbullet-ai-mcp

Detects the agents on your machine, shows the access level and pins the version.

Other ways to install

Access and checks

How we review

Extended accessThe tool runs code or makes network calls and only reads external data.

  • Plug tools create and change notes; the built-in tool list includes Lua execution.

This is third-party code. Review the repository files before installing.

What it does

SilverBullet handles Markdown notes, and the silverbullet-ai plug connects language models to them: chat, vector-embedding search, agents, prompt templates. The `silverbullet-ai-mcp` package from the `mcp-bridge` folder makes the plug tools available to MCP clients: Claude Code, Claude Desktop and Cursor. The server reaches the space through the SilverBullet Runtime API. Among the plug tools the README lists reading, creating and editing notes, search, page navigation and Lua execution with approval gates. The server address is set with the `SB_URL` variable.

Who it is for. SilverBullet users who want to work with their notes from Claude Code or Cursor.

Good fit when

  • An agent in Claude Code searches the notes and creates a new summary page.
  • Several clients must read one SilverBullet space.
  • Plug tools have to be called outside the SilverBullet interface.
  • An agent helps tidy notes: names, tags, structure.

Not a fit when

  • You do not use SilverBullet and the silverbullet-ai plug.
  • The Runtime API cannot be enabled on the SilverBullet server.
  • Notes have no backup: the plug inserts and replaces text and the README asks for a backup.

Example request

Find all pages about release planning in my notes and build one summary page from them.

MCP

Transport
stdio
Authentication
not required

Environment variables

SB_URL required
SilverBullet server address, for example `http://localhost:3000`.

Limitations

It needs the Runtime API enabled on the SilverBullet server, the silverbullet-ai plug installed in the space, preferably the same version as the package, and Node.js 20 or newer. The author calls the plug very new and not yet stable, and the package version in `package.json` is 0.0.0. The tools change notes and can run Lua, so back up the space before first experiments. The plug licence is AGPL-3.0.

How to disable. Remove the `silverbullet` server from client configuration or run `claude mcp remove silverbullet`. The plug is disabled separately in the space.

FAQ

How do I connect silverbullet-ai-mcp to Claude Code?

Run `claude mcp add silverbullet --env SB_URL=http://localhost:3000 -- npx -y silverbullet-ai-mcp`, substituting your own SilverBullet server address.

What does the SilverBullet side need?

The Runtime API enabled and the silverbullet-ai plug installed. Keep the package and plug versions the same.

How do I set up Claude Desktop?

In `claude_desktop_config.json` add a `silverbullet` server with the command `npx`, arguments `-y silverbullet-ai-mcp` and the `SB_URL` variable.

Where is the full documentation?

On the project site `ai.silverbullet.md`, the MCP Server section.

Which models does the plug itself support?

The README lists OpenAI, Google Gemini, Ollama, Mistral AI, Perplexity, OpenRouter and any OpenAI-compatible API.

Discussion

No questions or reviews yet.

MCP servers
Official

The official Kibela MCP server searches, reads and edits notes, folders and comments of your wiki straight from an assistant chat

MCP serverExtended access16

Joplin MCP Server opens your notes to an AI assistant: search, read, create, edit, delete and import Markdown files.

MCP serverExtended access96

An MCP server for Apple Notes on Mac: the agent reads, searches, creates, edits and exports notes and manages folders and tags.

MCP serverBroad access187

An MCP server for a BookStack wiki: read and search by default, writes enabled separately, rights taken from the token.

MCP serverExtended access55
Official

A read-only MCP server: Claude Code, Claude Desktop and Codex search local DoodleNote meetings, notes and transcripts

MCP serverExtended access186
Official

A Rust MCP server for a folder of Markdown notes: an agent searches and reads notes and sees backlinks, tags, tasks and version history

MCP serverExtended access1.6K

README in short

The plug repository also holds an `mcp-bridge` folder with a separate package. The plug README lists features and commands, while the MCP bridge description is on the project site.

README badge

Report a problem