tiddly-mcp
Model Context Protocol (MCP) server for TiddlyWiki - enables AI agents to interact with your wiki.
Install / Use
claude mcp add rryan -- npx -y github:rryan/tiddly-mcpIf the server publishes to npm under a different name, use that package instead — check the repo README.
MCP Server
Model Context Protocol server
Quality Score
Category
Development & EngineeringSupported Platforms
Tags
Our assessment of tiddly-mcp
tiddly-mcp scores 69/100 on our quality scale, 3949th of 4,728 Development & Engineering skills we index.
Its MCP Server is 2.8 KB long, split into 5 sections with 3 code examples: a solid amount of guidance for an agent.
It has 10 GitHub stars, so there is little community track record yet; judge it on its content.
Maintenance, license and trust
- The repository was last updated about 11 months ago. That is recent enough to be usable, but agent tooling moves fast, so check the instructions against your agent's current version.
- It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 86/100, with 2 cautions from licensing, adoption, age or documentation. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
tiddly-mcp compared with similar skills
All 4 of these similar skills score higher than tiddly-mcp; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| tiddly-mcp (this skill)by rryan | 69 | 10 | 11mo ago | MCP Server |
| taste-skillby Leonxlnx | 100 | 118.1k | 9d ago | CLAUDE.md |
| Agent-Reachby Panniantong | 100 | 112.9k | 10d ago | CLAUDE.md |
| hyperframesby heygen-com | 100 | 86.2k | today | CLAUDE.md |
| rufloby ruvnet | 100 | 82.0k | today | CLAUDE.md |
Frequently asked questions
- How do I install tiddly-mcp?
- Run
claude mcp add rryan -- npx -y github:rryan/tiddly-mcp. The install tabs above show the steps for each supported agent. - Which AI agents does tiddly-mcp work with?
- It is written for Claude Code and Claude Desktop, as a MCP Server file. Other agents that read the same format can often use it too.
- Is tiddly-mcp safe to use?
- It is MIT-licensed and scores 86/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is tiddly-mcp still maintained?
- The repository was last updated about 11 months ago. That is recent enough to be usable, but agent tooling moves fast, so check the instructions against your agent's current version.
Skill content
View source on GitHubTiddly 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.
Related Skills
taste-skill
118.1kAgent skills that give coding agents taste: art direction, reference images and a browser check instead of generic AI pages
Agent-Reach
112.9kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
hyperframes
86.2kAI video you can actually edit. HyperFrames is a free, open-source AI video editor. Describe any video and get a real project you can change down to the frame.
ruflo
82.0k🌊 The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, federation, vector RAG integration, and native Claude Code / Codex / Hermes and many more Integrated
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
