Markdown Writer MCP Server

An MCP (Model Context Protocol) server for TypingMind that writes, reads, appends, lists, and deletes markdown files — each stored in an automatically generated unique-ID folder.

Features

| Tool | Description | |---|---| | write_markdown | Create a new .md file in a fresh unique-ID folder | | append_markdown | Append content to an existing markdown file | | read_markdown | Read file contents back by folder ID | | list_markdown_files | List all folders and their markdown files | | delete_markdown | Delete a folder and its files (requires confirmation) |

Quick Start

1. Install

cd markdown-writer-mcp
npm install

2. Register with TypingMind MCP Connector

POST to your MCP Connector's /start endpoint:

curl -X POST http://localhost:50880/start \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "mcpServers": {
      "markdown-writer": {
        "command": "node",
        "args": ["/absolute/path/to/markdown-writer-mcp/index.js"],
        "env": {
          "MARKDOWN_OUTPUT_DIR": "/path/to/your/output/folder"
        }
      }
    }
  }'

3. Use in TypingMind

Once connected, the five tools are available to any AI model in TypingMind. Example prompts:

• "Write a markdown file with my meeting notes from today"
• "List all my saved markdown documents"
• "Read back the file from folder abc123def456"
• "Append an action items section to folder abc123def456"
• "Delete folder abc123def456 — I confirm"

Configuration

| Env Variable | Default | Description | |---|---|---| | MARKDOWN_OUTPUT_DIR | ./output | Base directory where unique-ID folders are created |

Output Structure

output/
├── a1b2c3d4e5f6/
│   └── meeting-notes.md
├── f6e5d4c3b2a1/
│   └── document.md
└── 1a2b3c4d5e6f/
    ├── project-plan.md
    └── appendix.md

Security

• Path traversal protection on all folder ID inputs
• Filename sanitisation (only alphanumeric, hyphens, underscores, dots, spaces)
• Delete requires explicit confirm: true flag