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)

"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>"
  }
}

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 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>"
  }
}

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

Install Server

HTTP connection URL

security – no known vulnerabilities

license - not found

quality - confirmed to work

How are these scores calculated?

local-only server

The server can only run on the client's local machine because it depends on local resources.

Tools

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.

Related MCP Servers

Spiral MCP Server
jxnl
-
security
F
license
-
quality
A Model Context Protocol server implementation that provides a standardized interface for interacting with Spiral's language models, offering tools to generate text from prompts, files, or web URLs.
Last updated -
14
Python
Confluence MCP
cosmix
A
security
A
license
A
quality
A Model Context Protocol server that enables AI assistants to interact with Confluence content, supporting operations like retrieving, searching, creating, and updating pages and spaces.
Last updated -
9
3
TypeScript
MIT License
MCP-Server-TESS
diegofornalha
-
security
F
license
-
quality
A Model Context Protocol server that enables integration with the TESS API, allowing users to list and manage agents, execute agents with custom messages, and manage files through natural language interfaces.
Last updated -
TypeScript
MCP Todoist
dkeesey
-
security
F
license
-
quality
A Model Context Protocol server that enables Claude to interact with your Todoist account, allowing you to manage tasks, projects, and labels through natural language.
Last updated -
1
Python

View all related MCP servers

TriliumNext Notes' MCP Server