Ahmad-A0/silverbullet-mcp

View on GitHub ↗

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

36 ★9 forksTypeScriptUpdated 4mo ago

What you need to know

MCP server that bridges to a self-hosted SilverBullet notes instance via Docker Compose. Exposes SilverBullet notes and data as MCP tools and resources over Streamable HTTP with token-based authentication.

Install

git clone <repo-url>
cp .env.example .env
docker-compose up --build

Usage

  • •Set SB_AUTH_TOKEN and MCP_TOKEN in .env, start both containers, and connect an MCP client to http://localhost:4000/mcp (or via mcp-remote).

Key features

  • ✓Read/write SilverBullet notes via MCP tools and resources
  • ✓Runs alongside SilverBullet via Docker Compose
  • ✓Token-based auth (Authorization header or ?token=)

Best for

Giving agents secure access to a self-hosted SilverBullet space

Caveats

  • ⚠Requires Docker and Docker Compose
  • ⚠Token-based authentication required

Reviewed 2026-08-11

Topics

end-user-programmingknowledge-managementmarkdownmcpmcp-servermodel-context-protocolnote-takingpersonal-knowledge-managementsilverbulletsilverbullet-plugins
Stars
36★
Forks
9
Language
TypeScript
License
MIT
Created
2025-05-23
Last push
2026-04-10