What is Triliumnext Mcp

triliumnext-mcp is a prototype MCP server designed for TriliumNext Notes, enabling interaction with Trilium Notes instances through various note management tools.

Use cases

Use cases include managing personal notes, organizing project documentation, and facilitating team collaboration through shared notes.

How to use

To use triliumnext-mcp, clone the repository, install dependencies, build the server, and configure it in the Claude Desktop application with the appropriate API URL and token.

Key features

Key features include creating, updating, retrieving, searching, and deleting notes, with support for various note types such as text, code, and images.

Where to use

triliumnext-mcp can be used in personal note-taking, project management, and collaborative environments where TriliumNext Notes is utilized.

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:

• TRILIUM_API_URL (default: http://localhost:8080/etapi)
• TRILIUM_API_TOKEN (required, get this from your Trilium Notes settings)

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 Local Installation (on Windows)

For Local installation (on Linux)

For Development (on Windows / Linux)

cd /path/to/triliumnext-mcp
npm run build

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