secondbrain-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| SB_URL | Yes | Base URL of your SilverBullet space, e.g. http://localhost:3000 (required). | |
| SB_TOKEN | No | Sent as Authorization: Bearer; must match SB_AUTH_TOKEN on the SilverBullet server. Required if your SilverBullet instance has authentication enabled. | |
| SB_EXCLUDE | No | Comma-separated prefixes treated as system pages. | Library/,Repositories/,SETTINGS,CONFIG |
| SB_ALLOW_WRITE | No | Enables the write tools (write_page / append_to_page). | false |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| list_pagesB | List pages in the second brain (SilverBullet space) with last-modified date and size. |
| read_pageA | Read the raw markdown of a page. Name is the page path without .md, e.g. 'projects/website/roadmap'. Note: ${...} Lua expressions and query blocks are returned unevaluated. |
| searchA | Search page names and contents (case- and accent-insensitive). All terms must match. Returns matching pages ranked by relevance with snippets. |
| recent_pagesC | List the most recently modified pages. |
| list_tasksA | List markdown tasks (- [ ] / - [x] / custom states) across the space. |
| list_tagsA | List all #tags (inline and frontmatter) with the number of pages using each. |
| pages_by_tagA | Find pages tagged with a given tag (with or without #). Matches sub-tags too, e.g. 'project' matches 'project/website'. |
| backlinksA | Find pages that link to the given page via [[wiki links]] or relative markdown links. |
| page_outlineB | Get a page's frontmatter, headings, tags and outgoing links without the full body. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 9 tools
Most tools target clearly distinct retrieval concerns: tag inventory, page listing, full-text search, recent pages, tag filtering, backlinks, tasks, and outlines. There is some overlap among list_pages, recent_pages, search, and pages_by_tag since all can return page sets, but the descriptions make their filters and purposes reasonably clear.
The names mix verb-first forms (list_tags, list_pages, read_page, search, list_tasks) with noun-phrase forms (recent_pages, pages_by_tag, backlinks, page_outline). The mixed conventions are still understandable, but they do not follow a single predictable pattern.
Nine tools is well-scoped for a note/knowledge-base server. Each tool corresponds to a meaningful retrieval operation without excessive surface area.
The read-oriented surface covers search, listing, reading, metadata, tags, tasks, backlinks, and recency well. However, it lacks any create, update, delete, or task-toggle operations, which are notable gaps for a second-brain workflow if write access is intended.