Trilium MCP Proxy
Provides an OAuth front for Trilium Notes' built-in MCP server, letting clients log in with a Trilium password and then use Trilium's native MCP tools through forwarded /mcp requests.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
trilium-mcp-proxy
An OAuth front for the MCP server that Trilium Notes 0.106+ has built in
at /mcp. On its own, Trilium's MCP server takes an ETAPI token in the Authorization header, so
every client needs a token created under Options → ETAPI and pasted into its configuration.
The proxy is a convenience on top: you add its URL to any MCP client (claude.ai, Claude Code, the Claude desktop and mobile apps, …) and log in once with your Trilium password. No token to create, paste or rotate.
Login: a client logs in once in the browser with the Trilium password, which creates an ETAPI token for that client. The client then only holds opaque OAuth tokens that refresh on their own.
Your password stays on your server: the proxy runs next to Trilium and the login page is its own. The password goes only from your browser to that page and on to your Trilium's
/etapi/auth/login; the proxy never stores or logs it. The MCP client (claude.ai included) never sees it, only opaque OAuth tokens that work nowhere but your proxy.Forwarding: every
/mcprequest goes unchanged to Trilium, with onlyAuthorizationswapped for that client's ETAPI token. Responses stream back as they arrive. The tools are exactly Trilium's own, so new ones from a Trilium update appear without a proxy release.House rules: with
MCP_INSTRUCTIONSset, the proxy adds your standing instructions to Trilium'sinitializeanswer, which every client reads at connect. That's the only rewrite.Header clients still work: a client that already has an ETAPI token (Claude Code) can send it, with or without
Bearer, and it's forwarded as is.Revocation: revoking a client's login logs its ETAPI token out in Trilium.
The login comes from mcp-login-oauth. It replaces trilium-mcp, an ETAPI-based MCP server that is archived now that Trilium has its own.
Documentation
Full documentation: trilium-mcp-proxy.marceltov.de
Quick start: turn on Trilium's MCP server, add the proxy, publish it over HTTPS
Connect a client: claude.ai and the Claude apps, Claude Code, other MCP clients
Related MCP server: Collaborative MCP Proxy Server
Run it
Enable Trilium's MCP server first: Options → AI / LLM → MCP server. Then add the proxy next to Trilium:
services:
trilium:
image: triliumnext/trilium:v0.106.1
# ...
trilium-mcp-proxy:
image: ghcr.io/marceltov/trilium-mcp-proxy:latest # or pin a version
restart: unless-stopped
environment:
TRILIUM_SERVER_URL: http://trilium:8080
MCP_BASE_URL: https://trilium-mcp-proxy.example.org # the public URL, behind your TLS proxy
MCP_OAUTH_SECRET: ${MCP_OAUTH_SECRET} # openssl rand -hex 32
MCP_INSTRUCTIONS: |
Optional standing instructions every client sees at connect.
volumes:
- mcp-proxy-oauth:/data
ports:
- "8081:8081"
volumes:
mcp-proxy-oauth:Put it behind a TLS reverse proxy at MCP_BASE_URL. GET /health answers
{"status": "ok", "trilium": "ok" | "unreachable"}.
Variable | Default | Meaning |
| required | Trilium Notes as the proxy reaches it, e.g. |
| required | Public URL of the proxy; also the OAuth issuer ( |
| required | Encrypts the stored logins in |
| unset | Added to Trilium's |
|
|
Connect a client
claude.ai (and the desktop and mobile apps): Customize → Connectors → Add custom connector with
https://<your proxy>/mcp. claude.ai opens the proxy's login page; enter your Trilium password.Claude Code: either the same URL (Claude Code does OAuth too), or with an ETAPI token from Options → ETAPI:
claude mcp add --transport http trilium https://<your proxy>/mcp -H "Authorization: Bearer <token>" -s user. With a token, Claude Code can also talk to Trilium's/mcpdirectly. The proxy only adds the house rules then.
Each OAuth login creates its own ETAPI token, which shows up in Trilium under Options → ETAPI. Deleting it there cuts that client off. Revoking the login from the client deletes it too.
Development
uv sync
uv run pytest -q --ignore=tests/live # unit tests, against a fake Trilium
./run-tests.sh -q # unit + live, against a disposable Trilium 0.106.1 (Docker)License
Copyright © 2026 Marcel Bruckner.
Licensed under the GNU Affero General Public License v3.0 or later (AGPL-3.0-or-later). You may use, modify, and redistribute it, but any modified version — including one you run as a network service — must be released under the same license with its source made available to its users, and the original copyright notice preserved. See LICENSE for the full terms.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Browser MCP for logged-in tasks. Uses your Chrome — credentials stay local. Zero-token replay.
ADHD second brain for Claude, ChatGPT & any MCP AI: notes, tasks, contacts. OAuth; can't delete.
Official Fibery MCP server: query and update your workspace from any AI client via OAuth.
Trainual MCP server for ChatGPT, Claude and any AI agent: list subjects, get subject, create subject, add step, update step, publish subject, assign subject and list assignments in your own Trainual account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to Trainual yourself; Cotlet does not store your password and you need no Trainual API key. About the official Trainual API: Trainual has a REST API and a read-only MCP server, but neither creates or edits training content (checked 28 Oct 2026). The API covers users, groups, responsibilities, assignments, completions, activities and webhooks, and it only views and searches published content. Setup and FAQ: https://cotlet.dev/integrations/trainual-api-mcp-server
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceEnables Claude.ai to connect to a Hermes MCP server via OAuth 2.1 authorization code flow with PKCE, acting as a reverse proxy and single-user authorization gateway.-
- AlicenseNot gradedqualityDmaintenanceEnables multi-AI collaborative analysis by proxying requests to existing login-based MCP servers (Gemini CLI and Codex CLI) from Claude Desktop or Claude Code.MIT
- FlicenseNot gradedqualityNot gradedmaintenanceEnables deploying a remote MCP server on Cloudflare Workers with OAuth login, allowing MCP clients like Claude Desktop to connect and use tools over SSE.-
- AlicenseNot gradedqualityDmaintenanceActs as a secure OAuth 2.0/2.1 proxy gateway for MCP servers, enabling integration with Claude and ChatGPT platforms.16 npmMIT