mcpField
S
silverbullet-ai-mcp

silverbullet-ai-mcp

Local
ai.silverbullet.mdProductivity107Updated 3w ago
RepositoryVisit website

About silverbullet-ai-mcp

silverbullet-ai-mcp is an MCP server that exposes the silverbullet-ai tools from a SilverBullet space to MCP clients. It suits users who want to work with their SilverBullet notes from Claude Code, Claude Desktop or Cursor.

Key features

  1. 01Exposes silverbullet-ai plug tools to MCP clients
  2. 02Connects to a SilverBullet server through SB_URL
  3. 03Runs via npx without a separate installation
  4. 04Requires Node.js 20 or later

Use cases

  1. 01Working with SilverBullet space content from Claude Code
  2. 02Calling space tools from Claude Desktop
  3. 03Accessing a SilverBullet space from Cursor

MCP support

This project is an MCP server that exposes the silverbullet-ai tools in a SilverBullet space to MCP clients such as Claude Code, Claude Desktop and Cursor.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "justyns-silverbullet-ai": {
      "command": "npx",
      "args": [
        "-y",
        "silverbullet-ai-mcp"
      ],
      "env": {
        "SB_URL": "<SB_URL>",
        "SB_AUTH_TOKEN": "<SB_AUTH_TOKEN>",
        "SB_SPACE_ID": "<SB_SPACE_ID>"
      }
    }
  }
}
Run commandnpx -y silverbullet-ai-mcp
Environment variables to set
SB_URLBase URL of your SilverBullet server, or 'desktop' for the SilverBullet+ desktop app
SB_AUTH_TOKENSecretThe server's SB_AUTH_TOKEN, if it runs with token auth
SB_SPACE_IDIn desktop mode, which space to connect to

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npmsilverbullet-ai-mcp0.10.0-alpha.4

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

silverbullet-ai-mcp

MCP server that exposes the silverbullet-ai tools in a SilverBullet space to MCP clients like Claude Code, Claude Desktop and Cursor.

Full docs: https://ai.silverbullet.md/MCP%20Server/

Requirements

  • The Runtime API enabled on your SilverBullet server.
  • The silverbullet-ai plug installed in the space, preferably the same version as this package.
  • Node.js 20+.

Usage

Claude Code:

claude mcp add silverbullet --env SB_URL=http://localhost:3000 -- npx -y silverbullet-ai-mcp

Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "silverbullet": {
      "command": "npx",
      "args": ["-y", "silverbullet-ai-mcp"],
      "env": { "SB_URL": "http://localhost:3000" }
    }
  }
}

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.