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).

Servidor MCP de TriliumNext Notes

⚠️ AVISO LEGAL: Este es un prototipo para https://github.com/TriliumNext/Notes/issues/705 . Sugerido solo para desarrolladores. Por favor, crea una copia de seguridad de tus notas de Trilium antes de usar esta herramienta. ⚠️

Un servidor de protocolo de contexto de modelo para TriliumNext Notes. Este servidor proporciona herramientas para interactuar con su instancia de Trilium Notes a través de MCP.

Actualización: compatible con la última versión de TriliumNext v0.92.6

Nota: Se sugiere utilizar con la extensión Cline en VSCode, en lugar de Claude Desktop

Inicio rápido

Asegúrese de configurar primero sus variables de entorno:

  • TRILIUM_API_URL (predeterminado: http://localhost:8080/etapi )
  • TRILIUM_API_TOKEN (obligatorio, obténgalo de la configuración de Trilium Notes)

Instalación

1. Uso con Claude Desktop

Agregue la configuración del servidor a su archivo de configuración de Claude Desktop:

Agregue la siguiente configuración al objeto mcpServers en su archivo de configuración de Claude:

Para desarrollo (en 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>" } }

Para instalación local (en Linux)

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

Para instalación local (en 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>" } }

Ubicación del archivo de configuración:

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

Herramientas disponibles

El servidor proporciona las siguientes herramientas para la gestión de notas:

  • search_notes - Buscar entre notas
    • Requiere: consulta de búsqueda
    • Opcional: fastSearch (alternar búsqueda de texto completo), includeArchivedNotes
  • get_note - Recupera el contenido de una nota por ID
    • Requiere: ID de nota
  • create_note - Crea una nueva nota
    • Requiere: ID de nota principal, título, tipo, contenido
    • Opcional: tipo MIME para notas de código/archivo/imagen
    • Tipos de notas admitidos: texto, código, archivo, imagen, búsqueda, libro, relaciónMapa, render
  • update_note - Actualizar una nota existente
    • Requiere: ID de nota
    • Opcional: nuevo título, nuevo contenido
  • delete_note - Eliminar una nota
    • Requiere: ID de nota

Desarrollo

Si quieres contribuir o modificar el servidor:

# 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

Un servidor de protocolo de contexto modelo que permite la interacción con TriliumNext Notes, proporcionando herramientas para crear, buscar, recuperar, actualizar y eliminar notas a través de comandos de lenguaje natural.

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