Tiddly MCP
Tiddly MCP is a Model Context Protocol plugin for TiddlyWiki that lets you connect AI agents to your TiddlyWiki.
WARNING: This plugin is a work in progress.
This plugin is tested and works with:
The plugin only supports server (Node.JS-hosted) versions of TiddlyWiki.
This plugin provides the following tools to AI agents via MCP:
| Name | Description | Arguments |
|---|---|---|
list_tiddlers | List all tiddlers or filter them using a filter expression. | filter, limit, includeSystem, includeDetails |
read_tiddler | Read a tiddler by title. | title |
search_tiddlers | Search for tiddlers containing specific text. | query, field, caseSensitive |
write_tiddler | Create or update a tiddler by title. | title, text, tags, type, username |
delete_tiddler | Deletes a tiddler by title. | title |
The plugin defaults to read only mode. The update and delete tiddler tools are off by default.
Installation
This plugin only works with server (hosted on Node.JS) TiddlyWikis.
- Drag and drop
$__plugins_rryan_tiddly-mcp.jsoninto your Node.JS-hosted TiddlyWiki and import the tiddler, or copy thetiddly-mcpfolder into your TiddlyWiki plugin path. - Open the plugin configuration and customize the port and other settings.
- Restart your server and confirm you see
[MCP] TiddlyWiki MCP Server started on port XXXXin your logs.
Authentication
For now, we recommend not exposing this MCP server to the Internet. You can use the plugin locally with Gemini CLI, Claude Code, or Claude Desktop without any security risks.
If you do expose the plugin to the Internet, we recommend:
- Set it up behind a reverse proxy, just like your Node.JS-hosted TiddlyWik is.
- Use HTTP Basic Authentication to protect access. Most clients support custom
headers that allow you to provide a
Authentication: Basic asdf1234authentication header. - Set the CORS allowed hosts to the domain name you are hosting it on.
- Use a path other than
https://example.com/mcpto avoid attackers scanning for MCP servers.
Developing
To build the plugin JSON and folder:
pnpm install
pnpm build:folder
To run the unit tests:
pnpm test
To run integration tests with an MCP client against a development server:
pnpm test:live
Acknowledgements
- This plugin was initially authored by Claude Code and Gemini CLI.
- Thanks to https://github.com/tiddly-gittly/Modern.TiddlyDev for the nice TypeScript starter kit for TiddlyWiki plugin development.