MCPgee
MCPgee
MCPgeeMCPgee

SilverBullet

v1.0.0•Knowledge & Memory•stable

A Model Context Protocol (MCP) server to interact with your SilverBullet notes and data.

end-user-programmingknowledge-managementmarkdownmcpmcp-server
Share:
32
Stars
0
Downloads
0
Weekly
0/5
View on GitHub

What is SilverBullet?

SilverBullet is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to model context protocol (mcp) server to interact with your silverbullet notes and data.

A Model Context Protocol (MCP) server to interact with your SilverBullet notes and data.

This server falls under the Knowledge & Memory category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • A Model Context Protocol (MCP) server to interact with your

Use Cases

Access and manipulate SilverBullet notes through Model Context Protocol.
Integrate personal knowledge management with AI assistants.
Ahmad-A0

Maintainer

LicenseMIT
Languagetypescript
Versionv1.0.0
UpdatedMay 17, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux
View SourceBrowse All Servers

Installation

Manual Installation

npx silverbullet

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use SilverBullet

The SilverBullet MCP server acts as a bridge between AI assistants and your self-hosted SilverBullet personal knowledge management system, exposing your notes and data through standardized MCP tools and resources. It runs as a Docker-based service alongside SilverBullet and authenticates via tokens, allowing large language models to read, search, and write to your markdown-based note collection. This is ideal for users who want to query or update personal notes using natural language through Claude or another MCP-compatible client.

Prerequisites

  • Docker and Docker Compose installed on the host machine
  • A running SilverBullet instance (self-hosted, accessible at a known URL)
  • SB_AUTH_TOKEN and MCP_TOKEN values chosen for securing the bridge
  • An MCP-compatible client such as Claude Desktop or any stdio-based MCP client
  • npx available if connecting via mcp-remote for stdio clients
1

Clone the repository

Clone the silverbullet-mcp repository to your server or local machine where Docker is available.

git clone https://github.com/Ahmad-A0/silverbullet-mcp
cd silverbullet-mcp
2

Create and configure the .env file

Copy the example environment file and fill in your SilverBullet API base URL plus authentication tokens. SB_AUTH_TOKEN must match your SilverBullet instance's auth token; MCP_TOKEN is what clients will use to authenticate with this MCP server.

cp .env.example .env
# Edit .env and set:
# SB_AUTH_TOKEN=your-silverbullet-auth-token
# MCP_TOKEN=your-chosen-mcp-client-token
# SB_API_BASE_URL=http://silverbullet:3000
# PORT=4000
3

Start the server with Docker Compose

Build and launch the MCP server container. The MCP server listens on port 4000 and proxies requests to your SilverBullet instance.

docker-compose up --build
4

Verify the server is running

The MCP endpoint will be available at http://localhost:4000/mcp. You can confirm it is reachable with a curl request including your MCP_TOKEN in the Authorization header.

curl -H "Authorization: Bearer YOUR_MCP_TOKEN" http://localhost:4000/mcp
5

Connect your MCP client

For stdio-based clients like Claude Desktop, use npx mcp-remote to tunnel the HTTP connection. For HTTP-native clients, connect directly to the MCP endpoint with your MCP_TOKEN.

# For Claude Desktop (stdio via mcp-remote), add to claude_desktop_config.json:
# see examples section below

SilverBullet Examples

Client configuration

Claude Desktop configuration using mcp-remote to connect to the SilverBullet MCP server over HTTP with token authentication.

{
  "mcpServers": {
    "silverbullet": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "http://localhost:4000/mcp",
        "--header",
        "Authorization: Bearer YOUR_MCP_TOKEN"
      ]
    }
  }
}

Prompts to try

Example prompts that demonstrate interacting with your SilverBullet notes through the MCP server.

- "Search my notes for anything related to retirement planning and summarize the key points."
- "Create a new note called 'Q3 Goals' with a summary of my current project priorities."
- "List all notes tagged with #meeting from this month."
- "Based on my savings notes, create a 10-year retirement projection."

Troubleshooting SilverBullet

401 Unauthorized when connecting from Claude Desktop

Verify that the MCP_TOKEN in your .env file matches exactly what you placed in the Authorization header or ?token query parameter. Restart the Docker container after any .env change.

Server cannot reach SilverBullet (connection refused or timeout)

Check that SB_API_BASE_URL in .env points to the correct hostname. When both services run in Docker Compose, use the service name (e.g., http://silverbullet:3000), not localhost.

mcp-remote fails to establish a connection

Ensure the MCP server container is running and port 4000 is exposed. Confirm that Node.js and npx are available in the environment where mcp-remote runs, and that the URL does not have a trailing slash.

Frequently Asked Questions about SilverBullet

What is SilverBullet?

SilverBullet is a Model Context Protocol (MCP) server that model context protocol (mcp) server to interact with your silverbullet notes and data. It connects AI assistants to external tools and data sources through a standardized interface.

How do I install SilverBullet?

Follow the installation instructions on the SilverBullet GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with SilverBullet?

SilverBullet works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is SilverBullet free to use?

Yes, SilverBullet is open source and available under the MIT license. You can use it freely in both personal and commercial projects.

Learn More About MCP Servers

Getting Started with MCP

Set up your first MCP server in minutes

MCP Setup Guide

Configure MCP in Claude, Cursor & VS Code

All MCP Tutorials

18+ hands-on guides for developers

MCP FAQ

40+ answers about Model Context Protocol

SilverBullet Alternatives — Similar Knowledge & Memory Servers

Looking for alternatives to SilverBullet? Here are other popular knowledge & memory servers you can use with Claude, Cursor, and VS Code.

MemPalace

★ 52.6k

A local AI memory system that stores all conversations verbatim and organizes them into navigable structures. It provides 19 MCP tools for AI assistants to search and retrieve past decisions, debugging sessions, and architecture debates automatically

Kratos

★ 25.7k

🏛️ Memory System for AI Coding Tools - Never explain your codebase again. MCP server with perfect project isolation, 95.8% context accuracy, and the Four Pillars Framework.

Context Mode

★ 15.4k

An MCP server that preserves LLM context by intercepting large data outputs and returning only concise summaries or relevant sections. It enables efficient sandboxed code execution, file processing, and documentation indexing across multiple programm

Memu

★ 13.7k

Memory for 24/7 proactive agents like OpenClaw.

MemOS

★ 9.3k

MemOS (Memory Operating System) is a memory management operating system designed for AI applications. Its goal is: to enable your AI system to have long-term memory like a human, not only remembering what users have said but also actively invoking, u

Everos

★ 5.4k

Build, evaluate, and integrate long-term memory for self-evolving agents.

Browse More Knowledge & Memory MCP Servers

Explore all knowledge & memory servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Knowledge & MemoryBrowse All Servers

Quick Config Preview

{ "mcpServers": { "silverbullet": { "command": "npx", "args": ["-y", "silverbullet"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use SilverBullet?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides
Explore All ServersRead Our Guides