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 |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| search_tiddlers | 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_tiddler | 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_tiddler | 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_tiddler | 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 |