TriliumNext Notes' MCP Server

by tan-yong-sheng
Verified

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

  • Provides tools for interacting with a Trilium Notes instance, enabling note management operations including creating, searching, retrieving, updating, and deleting notes of various types (text, code, file, image, search, book, relationMap, render).

TriliumNext Notes' MCP Server

⚠️ 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. ⚠️

A model context protocol server for TriliumNext Notes. This server provides tools to interact with your Trilium Notes instance through MCP.

Update: support latest version of TriliumNext v0.92.6

Note: Suggest to use with Cline extension in VSCode, instead of Claude Desktop

Quick Start

Make sure to set up your environment variables first:

Installation

1. Using with Claude Desktop

Add the server config to your Claude Desktop configuration file:

Add the following configuration to the mcpServers object in your Claude configuration file:

For Development (on Windows / Linux)

cd /path/to/triliumnext-mcp npm run build
"triliumnext-mcp": { "command": "node", "args": [ "/path/to/triliumnext-mcp/build/index.js" ], "env": { "TRILIUM_API_URL": "http://localhost:8080/etapi", "TRILIUM_API_TOKEN": "<YOUR_TRILIUM_API_TOKEN>" } }

For Local installation (on Linux)

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

For Local Installation (on Windows)

"triliumnext-mcp": { "command": "cmd", "args": [ "/k", "npx", "-y", "triliumnext-mcp" ], "env": { "TRILIUM_API_URL": "http://localhost:8080/etapi", "TRILIUM_API_TOKEN": "<YOUR_TRILIUM_API_TOKEN>" } }

Location of the configuration file:

  • Windows: %APPDATA%/Claude/claude_desktop_config.json
  • MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Available Tools

The server provides the following tools for note management:

  • search_notes - Search through notes
    • Requires: search query
    • Optional: fastSearch (fulltext search toggle), includeArchivedNotes
  • get_note - Retrieve a note content by ID
    • Requires: note ID
  • create_note - Create a new note
    • Requires: parent note ID, title, type, content
    • Optional: MIME type for code/file/image notes
    • Supported note types: text, code, file, image, search, book, relationMap, render
  • update_note - Update an existing note
    • Requires: note ID
    • Optional: new title, new content
  • delete_note - Delete a note
    • Requires: note ID

Development

If you want to contribute or modify the server:

# Clone the repository git clone https://github.com/tan-yong-sheng/triliumnext-mcp.git # Install dependencies npm install # Build the server npm run build # For development with auto-rebuild npm run watch

You must be authenticated.

A
security – no known vulnerabilities
F
license - not found
A
quality - confirmed to work

A model context protocol server that allows interaction with TriliumNext Notes, providing tools to create, search, retrieve, update, and delete notes through natural language commands.

  1. Quick Start
    1. Installation
      1. 1. Using with Claude Desktop
    2. Available Tools
      1. Development
        ID: rzhqu47to6