Skip to main content
Glama
Jyzus

hedgedoc-mcp-server

by Jyzus
OverviewSchemaRelated ServersScoreDiscussions
Python
Remote

HedgeDoc MCP Server

MCP server for HedgeDoc 1.x — the open-source collaborative markdown editor. Create notes and Mermaid diagrams from OpenCode and other MCP-compatible AI agents.

Note: This is built for HedgeDoc 1.x (formerly CodiMD). It uses the HedgeDoc 1.x API, which differs from HedgeDoc 2.

Tools

Tool

Description

hedgedoc_create_blank

Create a blank note with the instance's default template

hedgedoc_create

Create a new note with a random ID

hedgedoc_create_with_alias

Create a new note with a custom URL alias (requires FreeURL mode)

hedgedoc_create_diagram

Create a note with a Mermaid diagram

hedgedoc_read

Read the raw markdown content of a note

hedgedoc_info

Get note metadata (title, description, timestamps, viewcount)

hedgedoc_list_revisions

List all available revisions of a note

hedgedoc_get_revision

Get the full content of a specific revision

hedgedoc_publish_url

Get the published (read-only) URL of a note

hedgedoc_slide_url

Get the slide presentation URL of a note

hedgedoc_status

Get the current status of the HedgeDoc instance

Related MCP server: Joplin MCP Server

Usage

export HEDGEDOC_URL="https://hedgedoc.your-instance.com"
uvx hedgedoc-mcp-server stdio

HedgeDoc 1.x does not use API tokens for note operations. Authentication is handled via session cookies (browser) or instance configuration (see Production Ready guide).

OpenCode config

{
  "mcp": {
    "hedgedoc": {
      "type": "local",
      "enabled": true,
      "command": ["uvx", "hedgedoc-mcp-server", "stdio"],
      "environment": {
        "HEDGEDOC_URL": "https://hedgedoc.your-instance.com"
      }
    }
  }
}

Requirements

Requirement

Notes

HedgeDoc 1.x instance

Tested on 1.x. Not compatible with HedgeDoc 2.

Python 3.11+

uv (recommended)

Or pip install hedgedoc-mcp-server

API Endpoints Used

This server uses the following HedgeDoc 1.x API endpoints:

Method

Endpoint

Used by

GET

/new

Create a blank note

POST

/new

Create a note (random ID)

POST

/new/{alias}

Create a note (custom alias)

GET

/{id}/download

Read raw markdown

GET

/{id}/info

Read metadata

GET

/{id}/revision

List revisions

GET

/{id}/revision/{rev}

Get specific revision

GET

/{id}/publish

Published URL

GET

/{id}/slide

Slide URL

GET

/status

Instance status

For more details, see the official API docs.

Instance Configuration

Your HedgeDoc administrator may need to configure these settings:

Setting

Impact

Docs

CMD_ALLOW_ANONYMOUS=true

Allows note creation without login

Users and Privileges

CMD_ALLOW_FREEURL=true

Enables custom URL aliases

Users and Privileges

CMD_RATE_LIMIT_NEW_NOTES=20

Max new notes per 5 minutes (default: 20)

Web Security

CMD_DOCUMENT_MAX_LENGTH=100000

Max note length in chars (default: 100k)

HedgeDoc basics

CMD_DISABLE_NOTE_CREATION=false

If true, no notes can be created

Users and Privileges

Development

git clone https://github.com/Jyzus/kaymer-hedgedoc-mcp
cd kaymer-hedgedoc-mcp
uv venv && uv pip install -e .
HEDGEDOC_URL="https://hedgedoc.your-instance.com" uv run hedgedoc-mcp-server

License

MIT

Install Server
A
license - permissive license
A
quality
C
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

View all tools

Related MCP Servers

  • Joplin MCP Server

    alondmnt
    A
    license
    A
    quality
    A
    maintenance
    Enables AI assistants to interact with Joplin notes, notebooks, and tags through a standardized MCP interface, supporting CRUD operations, search, and organization.
    19
    158
    MIT

  • Joplin MCP Server

    jakubfrieb
    A
    license
    -
    quality
    C
    maintenance
    Enables AI assistants to interact with Joplin notes and notebooks, including searching, reading, and listing notebooks through natural language commands via the MCP protocol.
    129
    48
    MIT

  • Markdown Notes MCP

    codeMaestro78
    F
    license
    -
    quality
    D
    maintenance
    Enables managing and searching markdown notes with semantic search, question answering, and note generation, and provides an MCP server for GitHub Copilot integration.
    4

View all related MCP servers

Related MCP Connectors

  • TablaCognita

    MCP-native collaborative markdown editor with real-time AI document editing

  • Fresh Jots

    Read and write your Fresh Jots notes from Claude, Cursor, and any MCP client.

  • remnus

    MCP-native open-source Notion alternative: read & write pages, databases and kanban boards.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/Jyzus/kaymer-hedgedoc-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server