SilverBullet
Enables LLMs to interact with SilverBullet notes and data through a bridge server. Provides secure access to read and manipulate your SilverBullet space via standardized MCP tools and resources.
What is SilverBullet?
SilverBullet is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to enables llms to interact with silverbullet notes and data through a bridge server. provides secure access to read and manipulate your silverbullet space via standardized mcp tools and resources.
Enables LLMs to interact with SilverBullet notes and data through a bridge server. Provides secure access to read and manipulate your SilverBullet space via standardized MCP tools and resources.
This server falls under the Knowledge & Memory category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- Enables LLMs to interact with SilverBullet notes and data th
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx silverbullet-mcp-serverConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use SilverBullet
SilverBullet MCP Server is a bridge that allows AI assistants to securely read and manipulate notes in a SilverBullet personal knowledge base through standardized MCP tools and resources. It runs as a Docker-based HTTP server alongside your SilverBullet instance, using mutual token authentication so only authorized clients can access your notes. Knowledge workers who use SilverBullet as their note-taking and personal wiki system can use this bridge to ask their AI assistant questions about their notes, create or update pages, and perform complex knowledge retrieval across their entire space.
Prerequisites
- A running SilverBullet instance (self-hosted; see silverbullet.md for setup)
- Docker and Docker Compose installed for running the bridge server
- Two secret tokens to generate: one for SilverBullet authentication (SB_AUTH_TOKEN) and one for MCP client authentication (MCP_TOKEN)
- An MCP-compatible client such as Claude Desktop that supports HTTP MCP connections or mcp-remote
Clone the repository
Clone the silverbullet-mcp repository and enter the project directory.
git clone https://github.com/Ahmad-A0/silverbullet-mcp.git
cd silverbullet-mcpCreate and populate the environment file
Copy the example env file and fill in your SilverBullet URL and the two authentication tokens. Generate secure random tokens using openssl or a password manager.
cp .env.example .env
# Edit .env with your values:
# SB_AUTH_TOKEN=your-silverbullet-auth-token
# MCP_TOKEN=your-mcp-client-token
# SB_API_BASE_URL=http://silverbullet:3000
# PORT=4000Start the bridge server with Docker Compose
Build and start the MCP bridge container. Ensure your SilverBullet instance is reachable at the URL specified in SB_API_BASE_URL.
docker-compose up --buildConfigure Claude Desktop using mcp-remote
For stdio-based MCP clients like Claude Desktop, use mcp-remote as a proxy to the HTTP bridge server. Replace MCP_SERVER_TOKEN with your MCP_TOKEN value.
{
"mcpServers": {
"silverbullet": {
"command": "npx",
"args": [
"mcp-remote",
"http://localhost:4000/mcp",
"--transport", "http-only",
"--header", "Authorization:Bearer your-mcp-token"
]
}
}
}Verify the connection
Ask your AI assistant to list notes or retrieve a specific page from your SilverBullet space. A successful response confirms the bridge is working.
SilverBullet Examples
Client configuration
Claude Desktop configuration connecting to the SilverBullet MCP bridge via mcp-remote.
{
"mcpServers": {
"silverbullet": {
"command": "npx",
"args": [
"mcp-remote",
"http://localhost:4000/mcp",
"--transport", "http-only",
"--header", "Authorization:Bearer your-mcp-token"
]
}
}
}Prompts to try
Example prompts for interacting with your SilverBullet knowledge base through the MCP bridge.
- "What notes do I have about my retirement savings plan? Summarize the key figures."
- "Create a new page called 'Meeting Notes 2026-06-15' with today's date as the title."
- "Search my SilverBullet space for any notes mentioning the project 'Phoenix'."
- "What are my most recently edited pages in SilverBullet?"Troubleshooting SilverBullet
Docker Compose build fails or container exits immediately
Check the .env file exists and all required variables (SB_AUTH_TOKEN, MCP_TOKEN, SB_API_BASE_URL) are set. Run 'docker-compose logs' to see the specific error message.
MCP client gets 401 Unauthorized from the bridge
Ensure the Authorization header in your mcp-remote args matches the MCP_TOKEN in your .env file exactly, including capitalization. Rebuild the container after any .env changes with 'docker-compose up --build'.
Bridge cannot reach SilverBullet (connection refused on SB_API_BASE_URL)
Verify SilverBullet is running and accessible. If running both in Docker, they must be on the same Docker network. Use 'http://host.docker.internal:3000' if SilverBullet runs on the host machine and the bridge runs in Docker.
Frequently Asked Questions about SilverBullet
What is SilverBullet?
SilverBullet is a Model Context Protocol (MCP) server that enables llms to interact with silverbullet notes and data through a bridge server. provides secure access to read and manipulate your silverbullet space via standardized mcp tools and resources. 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 license. You can use it freely in both personal and commercial projects.
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.6kA 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.4kAn 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.7kMemory for 24/7 proactive agents like OpenClaw.
MemOS
★ 9.3kMemOS (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.4kBuild, 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.
Set Up SilverBullet in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
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.