TiddlyWiki MCP Server
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| MCP_PORT | No | HTTP server port (when using http transport) | 3000 |
| AUTH_USER | No | Username for TiddlyWiki API requests | mcp-user |
| OLLAMA_URL | No | Ollama API URL | http://localhost:11434 |
| AUTH_HEADER | No | HTTP header for authentication (can be any header your TiddlyWiki expects) | X-Oidc-Username |
| OLLAMA_MODEL | No | Embedding model name | nomic-embed-text |
| MCP_TRANSPORT | No | Transport mode: stdio or http | stdio |
| TIDDLYWIKI_URL | Yes | URL of your TiddlyWiki server (e.g., http://localhost:8080) | |
| EMBEDDINGS_DB_PATH | No | SQLite database path for embeddings | ./embeddings.db |
| EMBEDDINGS_ENABLED | No | Enable/disable semantic search | true |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {} |
| resources | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| search_tiddlersA | Search tiddlers using filter syntax, semantic similarity, or both. Supports filter-based queries (e.g., by tag, date, title), semantic/conceptual search, and hybrid combinations. Returns matching tiddlers with metadata and optionally text content. |
| update_tiddlerA | Update an existing tiddler. Shows a diff of changes and requests approval before applying. Preserves metadata like created timestamp. Supports arbitrary custom fields beyond the standard ones (e.g., caption, summary, author, or any TiddlyWiki field). |
| create_tiddlerA | Create a new tiddler. Shows a preview and requests approval before creating. Supports arbitrary custom fields beyond the standard ones (e.g., caption, summary, author, or any TiddlyWiki field). |
| delete_tiddlerA | Delete a tiddler. Shows current content and requests approval before deleting. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| TiddlyWiki Filter Syntax Reference | Complete reference documentation for TiddlyWiki filter operators and syntax |
TDQS
Scored across 4 tools
Each tool has a completely distinct purpose: create, delete, search, and update. There is no ambiguity or overlap among them.
All tool names follow the consistent verb_noun pattern: create_tiddler, delete_tiddler, search_tiddlers, update_tiddler. The singular vs plural in 'tiddler' vs 'tiddlers' is negligible.
With 4 tools, the set is well-scoped for a TiddlyWiki server. It covers the essential operations without being too sparse or overloaded.
The tools cover create, read (via search), update, and delete. A dedicated get_tiddler by ID is missing, but search can filter by title, so the gap is minor.