SkillAgentSearch skills...

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-mcp

If the server publishes to npm under a different name, use that package instead — check the repo README.

About this skill
🔌

MCP Server

Model Context Protocol server

Quality Score

69/100

Supported Platforms

Claude Code
Claude Desktop

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.

Substance
26/30
Structure
16/20
Description
12/15
Adoption
4/20
Freshness
11/15

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.

SkillScoreStarsUpdatedFormat
tiddly-mcp (this skill)by rryan691011mo agoMCP Server
taste-skillby Leonxlnx100118.1k9d agoCLAUDE.md
Agent-Reachby Panniantong100112.9k10d agoCLAUDE.md
hyperframesby heygen-com10086.2ktodayCLAUDE.md
rufloby ruvnet10082.0ktodayCLAUDE.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.

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.

  1. 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.
  2. Open the plugin configuration and customize the port and other settings.
  3. 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.

Related Skills

View on GitHub
GitHub Stars10
CategoryDevelopment
Updated10mo ago
Forks2

Languages

TypeScript

Trust signals

86/100

From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.

2 low1 info