silverbullet-mcp

How to use silverbullet-mcp

Docker Compose alongside your existing SilverBullet Docker container. It handles authentication and provides a secure way for external applications to access and manipulate your SilverBullet space.

Update the `.env` file with your specific values:
    *   `SB_AUTH_TOKEN`: A secure token for SilverBullet to authenticate with this MCP server and for this MCP server to authenticate with SilverBullet.
    *   `MCP_TOKEN`: A secure token for clients (e.g., your AI model) to authenticate with this MCP server.
    *   `SB_API_BASE_URL`: (Optional if running via docker-compose as defined) The base URL for the SilverBullet API. Defaults to `http://silverbullet:3000` in the `docker-compose.yml`.
    *   `PORT`: (Optional if running via docker-compose as defined) The port the MCP server will listen on. Defaults to `4000`.

3.  **Build and run the services using Docker Compose:**
    ```bash
    docker-compose up --build
    ```
    This command will:
    *   Build the Docker image for the `silverbullet-mcp-server` if it doesn't exist or if `Dockerfile` or related files have changed.
    *   Pull the latest `silverbulletmd/silverbullet` image.
    *   Start both the SilverBullet instance and the MCP server.

    The SilverBullet instance will be accessible at `http://localhost:3000`.
    The MCP server will be accessible at `http://localhost:4000`.

## Connecting to the MCP Server

This 

What is silverbullet-mcp?

silverbullet-mcp is a TypeScript MCP server for Claude Desktop, Cursor, Windsurf with npx, docker, git clone. A Model Context Protocol (MCP) server to interact with your SilverBullet notes and data. This profile combines repository metadata with install, compatibility, and usage signals so developers can quickly decide whether it fits their agent workflow before opening the source repository.

Key capabilities

• Tool access support
• Shell commands support
• Document generation support
• Anthropic provider support
• package.json config support
• Dockerfile config support
• Connecting agents to external tools and data

Technical details

Install or run silverbullet-mcp using npx. Check Ahmad-A0/silverbullet-mcp for the latest setup command.

• Built for TypeScript
• Built for Node.js
• Built for Docker
• Install or run with npx
• Install or run with docker
• Install or run with git clone
• Install or run with remote URL
• Works with Claude Desktop

Requirements and access

Security and permissions

Review permissions before connecting any MCP server to an agent. Pay special attention to whether it can read local files, write data, call external services, or perform destructive actions.

When to use silverbullet-mcp

• Use it for connecting agents to external tools and data.
• Use it for integrations workflows.
• Use it for coding workflows.
• Use it for data workflows.
• Use it for claude desktop users.

Built with

Explore related resources

Frequently asked questions