← Back to Skills Marketplace
ramonitor

SilverBullet API

by ramonitor · GitHub ↗ · v1.0.0
cross-platform ✓ Security Clean
1735
Downloads
1
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install silverbullet-skill
Description
MCP server for SilverBullet note-taking app - read, write, search, and manage markdown pages
Usage Guidance
This skill appears to do what it says — it performs HTTP calls to a SilverBullet server and exposes standard file/read/write/search tools. Before installing: 1) Verify the SILVERBULLET_URL you will set (prefer a local or trusted host); the skill can read/write any pages accessible at that URL, so pointing it at an untrusted remote host risks exposing your notes. 2) Inspect server.py and the package contents (you already have them) and confirm you are comfortable running uv pip install -e . locally. 3) Be aware the SKILL.md asks you to add a mcporter entry in ~/.mcporter/mcporter.json and to export SILVERBULLET_URL — these are normal but note the registry metadata did not declare the env var (minor inconsistency). 4) If you run the demo or tests, do so against a test or local SilverBullet instance to avoid accidental modification of production notes. If you want greater assurance, run the package install in an isolated environment and review network traffic from the process while testing.
Capability Analysis
Type: OpenClaw Skill Name: silverbullet-skill Version: 1.0.0 The skill provides an MCP server to interact with the SilverBullet note-taking application. All operations are confined to the SilverBullet REST API, primarily targeting `http://localhost:3000` by default, or a user-configured `SILVERBULLET_URL`. The installation script in `SKILL.md` performs standard Python package installation using `uv`. The `server.py` code uses `httpx` to make requests to the configured SilverBullet instance, offering tools to list, read, write, delete, and search pages. There is no evidence of data exfiltration to external endpoints, malicious execution (e.g., `curl|bash`), persistence mechanisms, obfuscation, or prompt injection attempts in `SKILL.md` or `README.md` designed to subvert the agent's behavior beyond its stated purpose. The capabilities are directly aligned with managing a note-taking application.
Capability Assessment
Purpose & Capability
The name, description, SKILL.md examples, and server.py tools all map to SilverBullet REST endpoints (.fs, .ping, .config). Required binaries and tools referenced in SKILL.md (python/uv, mcporter) are appropriate for running an MCP server and the provided pyproject lists expected deps (mcp[cli], httpx).
Instruction Scope
Runtime instructions confine activity to installing the package, configuring mcporter, setting SILVERBULLET_URL, and running the server. The SKILL.md does not direct the agent to read unrelated files, harvest system credentials, or transmit data to third-party endpoints outside the configured SilverBullet URL.
Install Mechanism
This is an instruction-first skill with a script-based install (uv venv + uv pip install -e .). Installing creates a virtualenv and installs from PyPI (mcp, httpx). This is expected for a Python MCP server, but the install writes files locally and runs package installs — review before running. No downloads from unknown hosts or URL shorteners are present.
Credentials
The code reads a single environment variable (SILVERBULLET_URL) to determine the server address, which is proportionate. However, registry metadata lists no required env vars while SKILL.md and README instruct the user to set SILVERBULLET_URL — this mismatch is a minor inconsistency to be aware of.
Persistence & Privilege
The skill does not request always:true and does not modify other skills or system-wide configuration. It suggests writing a mcporter entry (user-level config) which is appropriate for an MCP server integration.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install silverbullet-skill
  3. After installation, invoke the skill by name or use /silverbullet-skill
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
SilverBullet MCP server skill initial release. - Adds MCP server integration for the SilverBullet note-taking app. - Supports reading, writing, searching, and managing markdown pages via mcporter tools. - Provides installation and configuration steps for ClawdHub and manual setups. - Documents usage examples for all available tools and natural language requests. - Includes troubleshooting tips and references the SilverBullet HTTP API.
Metadata
Slug silverbullet-skill
Version 1.0.0
License
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is SilverBullet API?

MCP server for SilverBullet note-taking app - read, write, search, and manage markdown pages. It is an AI Agent Skill for Claude Code / OpenClaw, with 1735 downloads so far.

How do I install SilverBullet API?

Run "/install silverbullet-skill" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is SilverBullet API free?

Yes, SilverBullet API is completely free (open-source). You can download, install and use it at no cost.

Which platforms does SilverBullet API support?

SilverBullet API is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created SilverBullet API?

It is built and maintained by ramonitor (@ramonitor); the current version is v1.0.0.

💬 Comments