Which integrations are available for this server?

Enables AI agents to interact with TiddlyWiki instances, providing tools for listing, searching, filtering, creating, updating, and deleting tiddlers in Node.js-hosted TiddlyWiki servers.

How do I use Tiddly MCP?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Tiddly MCP list all tiddlers about project planning" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

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.json into your Node.JS-hosted TiddlyWiki and import the tiddler, or copy the tiddly-mcp folder 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 XXXX in 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 asdf1234 authentication header.
Set the CORS allowed hosts to the domain name you are hosting it on.
Use a path other than https://example.com/mcp to 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.