Read and write a self-hosted TriliumNext knowledge base over its ETAPI.
MCPpedia last refreshed this data
io.github.OVDEN13/trilium-mcp is an MCP server that read and write a self-hosted TriliumNext knowledge base over its ETAPI. Its tool list has not been published yet over stdio, requires no API key, and scores 65/100 on MCPpedia's security, maintenance and efficiency rubric.
Config is the same across clients — only the file and path differ.
{
"mcpServers": {
"trilium": {
"env": {
"TRILIUM_URL": "http://localhost:8092",
"TRILIUM_TOKEN": "your-token"
},
"command": "/absolute/path/to/trilium-mcp"
}
}
}Are you the author?
Add this badge to your README to show your security score and help users find safe servers.
An MCP server that lets AI agents (Claude Desktop, Claude Code, any MCP-compatible client) read and write a self-hosted TriliumNext knowledge base over its ETAPI.
No automated test available for this server. Check the GitHub README for setup instructions.
Five weighted categories — click any category to see the underlying evidence.
No known CVEs.
No package registry to scan.
Click any tool to inspect its schema.
Be the first to review
Have you used this server?
Share your experience — it helps other developers decide.
Sign in to write a review.
Others in education
A Model Context Protocol server for searching and analyzing arXiv papers
ARIS ⚔️ (Auto-Research-In-Sleep) — Lightweight Markdown-only skills for autonomous ML research: cross-model review loops, idea discovery, and experiment automation. No framework, no lock-in — works with Claude Code, Codex, OpenClaw, or any LLM agent.
1000+ scientific tools for AI scientists: life science, reserach, literature, and more.
Search open-source research papers across arXiv, OpenAlex, Crossref, PubMed, Semantic Scholar.
MCP Security Weekly
Get CVE alerts and security updates for io.github.OVDEN13/trilium-mcp and similar servers.
Start a conversation
Ask a question, share a tip, or report an issue.
Sign in to join the discussion.
An MCP server that lets AI agents (Claude Desktop, Claude Code, any MCP-compatible client) read and write a self-hosted TriliumNext knowledge base over its ETAPI.
Single static Go binary. No runtime dependencies. Talks to your local Trilium over HTTP(S) and to the client over stdio.
TriliumNext is a strong personal KB: tree-of-notes with attributes (labels, relations) that double as table columns / board lanes / calendar events. This MCP exposes the right slice of ETAPI so an agent can:
It is intentionally minimal: ten tools, ~600 lines of Go, zero clever abstractions.
| Tool | Purpose |
|---|---|
create_note | Create a note (optionally under a parent, with labels in one shot). |
batch_create_notes | Create many notes in one call — saves per-call schema overhead during restructuring. |
get_note | Fetch note metadata; optionally include body content. |
get_note_subtree | Recursively fetch a note + descendants up to N levels as a nested tree — replaces N+1 get_note calls. |
update_note | Partial update: include only the fields you want to change; omitted fields stay as-is. |
append_content | Append text to the body with a configurable separator. |
delete_note | Delete a note and its subtree. |
batch_delete_notes | Delete many notes; partial failures don't stop the rest. |
move_note | Re-parent a note in two ETAPI calls (vs the old read-recreate-delete dance). |
clone_note | Add the note under an additional parent — Trilium-native multi-parent links. |
delete_branch | Remove one parent-child link without deleting the note (un-clone). |
search_notes | Full-power Trilium search (#label, ~relation, note.title %= "regex", ancestor scoping, etc.). |
add_label | Attach a label (#key=value) — acts as a "column" in collection views. |
add_relation | Attach a relation (~name → noteId) — like a foreign key between notes. |
remove_attribute | Remove a label or relation by its attribute id. |
list_attributes | List all labels and relations on a note. |
If you don't already have one:
# docker-compose.yml
services:
trilium:
image: triliumnext/notes:latest
ports:
- "8092:8080"
volumes:
- ./data:/home/node/trilium-data
docker compose up -d
Open http://localhost:8092/, finish the setup wizard, then Options → ETAPI → Create new ETAPI token. Copy the token (shown only once).
Pre-built binary (recommended) — grab the right archive from Releases.
From source with Go 1.23+:
go install github.com/OVDEN13/trilium-mcp@latest
With Docker (no Go on host):
git clone https://github.com/OVDEN13/trilium-mcp && cd trilium-mcp
docker build -t trilium-mcp .
Copy .env.example to .env next to the binary:
TRILIUM_URL=http://localhost:8092
TRILIUM_TOKEN=your-etapi-token-here
# Optional:
# TRILIUM_HTTP_TIMEOUT_SECONDS=30
Or pass the same as real environment variables — the server reads either.
Claude Code (CLI):
claude mcp add --scope user trilium /path/to/trilium-mcp \
--env TRILIUM_URL=http://localhost:8092 \
--env TRILIUM_TOKEN=your-token
Claude Desktop — add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or the equivalent on your OS:
{
"mcpServers": {
"trilium": {
"command": "/absolute/path/to/trilium-mcp"
... [View full README on GitHub](https://github.com/ovden13/trilium-mcp#readme)