TriliumNext Notes' MCP Server

MCP server for TriliumNext Notes

Local serverstdioGo

What is the TriliumNext Notes' MCP Server?

MCP server for TriliumNext Notes

What it actually does

⚠️ DISCLAIMER: This is a prototype for https://github.com/TriliumNext/Notes/issues/705. Suggested only for developer use. Please backup your Trilium notes before using this tool. ⚠️

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
search_notesUnified search with comprehensive filtering capabilities including keyword search, date ranges, field-specific searches, attribute searches, note properties, template-based searches, note type filtering, MIME type filter
resolve_note_idFind a note's ID by its title. Essential for getting a note's ID to use with other tools.
list_children_notesList the direct child notes of a parent note using a deterministic search query. Returns child summaries sorted by creation date and title.
get_noteRetrieve a note and its content by ID. Can also be used with regex to extract specific patterns from the content.
create_noteCreate a new note. Supports 10 note types and allows creating attributes (labels and relations) in the same step.
update_noteUpdates a note's title or content. Requires a mode ('overwrite' or 'append') to specify the update type and an expectedHash to prevent conflicts.
move_noteMove a note to a new parent folder. Use branchId only when the note has multiple parent branches.
patch_noteApply targeted batched edits using mode-based patches (css, xpath, line, fragment, literal, regex) with atomic validation. Literal patches can use occurrence and optional context to target repeated text.
delete_notePermanently delete a note (⚠️ cannot be undone).
read_attributesRead all attributes (labels and relations) for a given note.
manage_attributesCreate, update, or delete attributes on a note. Supports batch creation.

How to install the TriliumNext Notes' MCP Server

{
  "mcpServers": {
    "triliumnext-mcp": {
      "command": "npx",
      "args": ["triliumnext-mcp"],
      "env": {
        "TRILIUM_API_URL": "http://localhost:8080/etapi",
        "TRILIUM_API_TOKEN": "<YOUR_TRILIUM_API_TOKEN>",
        "PERMISSIONS": "READ;WRITE"
      }
    }
  }
}

Configuration as documented by the project. Restart the client after saving.

Configuration

VariableDescriptionRequired
TRILIUM_API_URLEndpoint or connection string the server talks to.Yes
TRILIUM_API_TOKENCredential the server authenticates with.Yes
PERMISSIONSConfiguration value read at startup.Optional
MCP_TIMEOUTConfiguration value read at startup.Optional
MCP_TOOL_TIMEOUTConfiguration value read at startup.Optional
VERBOSEConfiguration value read at startup.Optional

Example prompts to try

  • “Use TriliumNext Notes' to search notes.”
  • “Use TriliumNext Notes' to resolve note id.”
  • “Use TriliumNext Notes' to list children notes.”

Frequently asked questions

`TRILIUM_API_TOKEN` is required. `TRILIUM_API_URL` defaults to `http://localhost:8080/etapi`. `PERMISSIONS` (default `READ;WRITE`) and `VERBOSE` (default `false`) are optional.