SilverBullet MCP Server

SilverBullet MCP Server is an MCP server that bridges Model Context Protocol clients with a self-hosted SilverBullet note-taking instance. Designed for knowledge workers, developers, and researchers who maintain personal knowledge bases in SilverBullet, this server exposes Markdown notes and workspace data through standardized MCP tools and resources. The server operates as an HTTP service packaged alongside SilverBullet in Docker Compose, handling authentication between clients and the local note repository. By connecting large language models to SilverBullet, users can perform natural language inquiries across their structured files, retrieve specific notes, and generate contextual analyses such as financial projections or project summaries directly from personal documentation. The service supports token-based authentication via HTTP authorization headers or query parameters, ensuring secure communication between external clients and the SilverBullet API. It supports direct connections for HTTP-capable MCP clients as well as standard input/output connections through proxy tools like mcp-remote for desktop applications including Claude Desktop, Cursor, and Windsurf, turning local notes into actionable AI context.

Category: Files, Documents & PDFs

Tags: knowledge-base, markdown, notes, silverbullet

Visit SilverBullet MCP Server

How to install and configure SilverBullet MCP Server

1. Clone the repository and create your configuration file: bash cp .env.example .env 2. Open .env and define SB_AUTH_TOKEN and MCP_TOKEN, adjusting optional variables like PORT and SB_API_BASE_URL if needed. 3. Build and launch the containers: bash docker-compose up --build 4. For stdio clients such as Claude Desktop or Cursor, configure claude_desktop_config.json or ~/.cursor/mcp.json using mcp-remote: json { "mcpServers": { "silverbullet-mcp": { "command": "npx", "args": [ "mcp-remote", "http://localhost:4000/mcp", "--transport", "http-only", "--header", "Authorization:Bearer ${MCP_SERVER_TOKEN}" ], "env": { "MCP_SERVER_TOKEN": "your_actual_mcp_token_from_dotenv" } } } } 5. Replace your_actual_mcp_token_from_dotenv with the MCP_TOKEN defined in your .env file.

What you can do with SilverBullet MCP Server

• Querying personal notes and journals to generate projections, summaries, or action items through natural language prompts in Claude Desktop. - Searching and extracting specific documentation or research material stored within your self-hosted SilverBullet space directly inside code editors. - Providing context from SilverBullet Markdown notes to AI coding assistants in Cursor or Windsurf while developing projects. - Bridging local HTTP-based SilverBullet instances with remote AI agents using token-authenticated Model Context Protocol endpoints.

Key facts

• Open Source
• https://github.com/Ahmad-A0/silverbullet-mcp
• Files, Documents & PDFs, Notes & Knowledge Management
• knowledge-base, markdown, notes, silverbullet

Part of MCP Servers

What can SilverBullet MCP Server do?

SilverBullet MCP Server connects Large Language Models to your SilverBullet note space by exposing tools and resources over the Model Context Protocol. It allows connected AI assistants to search, read, and interpret your personal Markdown notes, project documentation, and journal entries to answer questions and complete contextual analysis tasks.

How do I authenticate with SilverBullet MCP Server?

Authentication relies on token verification defined in your environment file. Clients connect using an authorization header containing the Bearer token or by appending the token parameter directly to the HTTP URL endpoint. For stdio clients using mcp-remote, the token is passed in the header argument within the client configuration file.

Which MCP clients work with SilverBullet MCP Server?

The server supports any Model Context Protocol client capable of streamable HTTP transport or stdio communication via mcp-remote. Compatible clients include Claude Desktop, Cursor, Windsurf, and custom AI agents. For stdio-only tools, mcp-remote bridges the local client process to the HTTP server running inside Docker.

Is SilverBullet MCP Server open source?

Yes, SilverBullet MCP Server is open source and hosted on GitHub under an open repository. Users can inspect the implementation, customize the Docker Compose deployment, submit bug reports, and contribute improvements directly to the project codebase to meet specific note management and security workflows.