TriliumNext Notes' MCP Server
@tan-yong-sheng
MCP server for TriliumNext Notes
Overview
What is TriliumNext Notes' MCP Server?
A Model Context Protocol (MCP) server for TriliumNext Notes. It provides tools to search, create, update, delete, and manage notes and attributes in your Trilium Notes instance via the ETAPI. This prototype is intended for developer use; backup your notes before using.
How to use TriliumNext Notes' MCP Server?
Install via npx triliumnext-mcp or run with Docker (pre‑built image from GitHub Container Registry). Configure environment variables: TRILIUM_API_URL (default http://localhost:8080/etapi), TRILIUM_API_TOKEN (required), PERMISSIONS (optional, default READ;WRITE), and VERBOSE (optional). Add the server configuration to your MCP client (e.g., Claude Desktop, Claude Code, Cursor, Cline) using stdio transport.
Key features of TriliumNext Notes' MCP Server
- Search and discover notes with advanced filtering.
- Create, read, update, and delete notes.
- Manage attributes (labels and relations) on notes.
- Resolve note IDs by title for reference.
- List and move notes between parent folders.
- Apply targeted batched edits using various patch modes.
Use cases of TriliumNext Notes' MCP Server
- Find recent notes about a topic filtered by date range.
- Show notes edited in the last 7 days.
- List all notes under a folder including subfolders.
- Add daily updates to a work log (append mode).
- Create a new note in a specific journal folder.
FAQ from TriliumNext Notes' MCP Server
What environment variables are required?
TRILIUM_API_TOKEN is required. TRILIUM_API_URL defaults to http://localhost:8080/etapi. PERMISSIONS (default READ;WRITE) and VERBOSE (default false) are optional.
Is this server production‑ready?
No – it is a prototype for developer use only. Always back up your Trilium notes before using this tool.
What data does this server access?
It interacts with your own Trilium Notes instance via the ETAPI. All data remains in your Trilium instance; no external storage is used.
What transport does the server use?
The server uses stdio transport and follows the standard MCP protocol, making it compatible with any MCP client.
