tiddlywiki-mcp-server

colygon/tiddlywiki-mcp-server

3.2

If you are the rightful owner of tiddlywiki-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

An MCP server designed to facilitate the creation and management of TiddlyWiki instances.

Tools
8
Resources
0
Prompts
0

TiddlyWiki MCP Server

An MCP (Model Context Protocol) server that enables Claude to create and manage TiddlyWiki instances with ease.

Features

  • Wiki Management: Create new TiddlyWiki instances
  • Tiddler Operations: Full CRUD operations for tiddlers
  • Content Organization: Tag and organize tiddlers
  • Export Functionality: Export wikis to HTML or JSON
  • Plugin Support: Install and manage TiddlyWiki plugins
  • Filtering: List tiddlers with TiddlyWiki filter expressions

Prerequisites

  • Node.js 18+
  • TiddlyWiki CLI globally installed: npm install -g tiddlywiki

Installation

npm install
npm run build

Usage

The server runs as an MCP server and provides the following tools:

Available Tools

  1. create_wiki - Create a new TiddlyWiki

    • name: Name of the wiki
    • path: Path where the wiki should be created
    • edition: (optional) TiddlyWiki edition

  2. create_tiddler - Create a new tiddler

    • wikiPath: Path to the wiki
    • title: Title of the tiddler
    • text: Content of the tiddler
    • tags: (optional) Array of tags
    • fields: (optional) Additional fields

  3. read_tiddler - Read a tiddler

    • wikiPath: Path to the wiki
    • title: Title of the tiddler

  4. update_tiddler - Update an existing tiddler

    • wikiPath: Path to the wiki
    • title: Title of the tiddler
    • text: (optional) New content
    • tags: (optional) New tags
    • fields: (optional) Additional fields

  5. delete_tiddler - Delete a tiddler

    • wikiPath: Path to the wiki
    • title: Title of the tiddler

  6. list_tiddlers - List tiddlers with optional filtering

    • wikiPath: Path to the wiki
    • filter: (optional) TiddlyWiki filter expression

  7. export_wiki - Export wiki to file

    • wikiPath: Path to the wiki
    • outputPath: Output file path
    • format: Export format ("html" or "json")

  8. install_plugin - Install a plugin

    • wikiPath: Path to the wiki
    • pluginName: Name of the plugin

Example Usage

Once connected to Claude with this MCP server, you can:

Create a new wiki for my project notes at ./my-wiki

Add a tiddler titled "Project Goals" with content about the objectives

List all tiddlers tagged with "important"

Export the wiki to HTML format

Development

npm run dev  # Watch mode
npm run build # Build
npm test # Run tests

License

MIT