Skip to content

SilverBullet

What it is

SilverBullet is an open-source, extensible, Markdown-based personal knowledge management system that runs in the browser. It features a unique "Space Script" capability that allows the entire environment to be programmed and queried using JavaScript and a custom query language. As of July 2026, it supports MCP 3.0 Task Protocol, allowing it to serve as a programmable backend for agentic workflows.

What problem it solves

It combines the simplicity of Markdown with the power of a programmable database. It solves the limitation of static Markdown notes by allowing for live queries, automated indexing, and custom templates that can transform a folder of text files into a functional application (e.g., a task manager, a project tracker, or a library catalog).

Where it fits in the stack

Category: Tool / Knowledge Management. It is a "hacker-friendly" alternative to Obsidian or Logseq, specifically designed for users who want to extend their knowledge base using code and queries directly within their notes. In July 2026, it often serves as a local-first source for Claude 5.1 and Gemma 3 via its integrated MCP server.

Typical use cases

  • Programmable Wiki: Building an internal knowledge base with automated indexes.
  • Task Management: Creating custom task dashboards using live queries.
  • Agentic Knowledge Retrieval: Exposing notes to AI agents via MCP 3.0 for autonomous research.
  • Data Scraping: Using Space Scripts to pull information from external APIs into notes.
  • Personal CRM: Managing contacts and interactions with structured metadata and automated summaries.

Strengths

  • Extensibility: Entirely programmable via Space Scripts (JavaScript).
  • Live Queries: Built-in SQL-like query language for Markdown blocks.
  • MCP 3.0 Support: Native support for the Model Context Protocol in July 2026.
  • Web-native: Runs in the browser but can sync to local storage or a remote server.
  • PWA support: Excellent mobile experience via Progressive Web App technology.

Limitations

  • Technical Barrier: Requires some knowledge of JavaScript or SilverBullet's query language to unlock its full potential.
  • Smaller Ecosystem: Fewer community plugins compared to Obsidian.
  • Self-Hosting: While it can run locally, a server component is required for the best multi-device experience.

When to use it

  • When you want a knowledge base that you can program and extend yourself.
  • If you prefer a browser-based workflow but want the power of a local-first application.
  • When you need to perform complex data queries across your entire note collection.

When not to use it

  • If you want a polished, consumer-grade app with a massive library of one-click plugins.
  • If you are uncomfortable with writing occasional scripts or queries to manage your data.

Getting started

1. Installation

The easiest way to run SilverBullet is via Docker: 

docker run -d \
  --name silverbullet \
  -p 3030:3030 \
  -v ./space:/space \
  zefhemel/silverbullet:latest
Alternatively, install via npm: npm install -g @silverbulletmd/silverbullet.

2. Space Initialization

Once running, navigate to http://localhost:3030. SilverBullet will automatically generate an Index Page with sections for quick notes and tasks.

Hello World Example

Create a new page (e.g., Hello) and add your first "Space Script" to verify the environment: 1. Create a page with Hello title. 2. Add the following block: 

#script
silverbullet.registerFunction("hello", (name) => {
  return `Hello, ${name}!`;
});
3. You can now use {{hello("World")}} in any page.

CLI examples

# Start SilverBullet in a specific directory
silverbullet ./my_notes_space

# Specify a custom port for the server
silverbullet --port 8080 ./my_space

# Run in "read-only" mode for public sharing
silverbullet --readonly ./my_space

# Start the integrated MCP server (v0.8.0+ / July 2026)
silverbullet mcp ./my_space

API examples

Integrated Query (SQL-like)

Embed live queries directly in your Markdown files to aggregate data: 

<!-- #query task where done = false limit 5 -->
| Name | Page |
| ---- | ---- |
| {{name}} | [[{{page}}]] |
<!-- /query -->

Space Script (JavaScript)

Register custom commands that can be invoked from the command palette: 

#script
silverbullet.registerCommand({
  name: "Current Date",
  callback: () => {
    const date = new Date().toLocaleDateString();
    editor.insertAtCursor(`Today is ${date}`);
  }
});

Direct API (HTTP)

SilverBullet exposes a REST API for space manipulation (requires authentication if configured): 

# Fetch the content of a specific page
curl http://localhost:3030/api/pages/Index/content

Sources / References

Contribution Metadata

  • Last reviewed: 2026-07-21
  • Confidence: high