MCP Hub › AI & Agents › HackMD

HackMD MCP server

by yuna0x0 · io.github.yuna0x0/hackmd-mcp

A Model Context Protocol server for integrating HackMD's note-taking platform with AI assistants.

🤖 AI & AgentsDockernpmv1.5.7
Open in MCP HubGitHub repository ↗

How to install HackMD

npm

claude mcp add -e HACKMD_API_TOKEN=<your-hackmd-api-token> hackmd-mcp -- npx -y [email protected]

Or add it to your MCP config (Claude Desktop, Cursor, VS Code):

{
  "mcpServers": {
    "hackmd-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "[email protected]"
      ],
      "env": {
        "HACKMD_API_TOKEN": "<your-hackmd-api-token>"
      }
    }
  }
}

Environment variables:
HACKMD_API_TOKEN (required) – Your HackMD API token for API authentication
HACKMD_API_URL – Optional HackMD API URL, defaults to https://api.hackmd.io/v1

Docker

claude mcp add -e HACKMD_API_TOKEN=<your-hackmd-api-token> hackmd-mcp -- docker run -i --rm ghcr.io/yuna0x0/hackmd-mcp:1.5.7

Or add it to your MCP config (Claude Desktop, Cursor, VS Code):

{
  "mcpServers": {
    "hackmd-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/yuna0x0/hackmd-mcp:1.5.7"
      ],
      "env": {
        "HACKMD_API_TOKEN": "<your-hackmd-api-token>"
      }
    }
  }
}

Environment variables:
HACKMD_API_TOKEN (required) – Your HackMD API token for API authentication
HACKMD_API_URL – Optional HackMD API URL, defaults to https://api.hackmd.io/v1

Replace placeholders in <angle brackets> with your own values. Review what a server can access before you enable it.

Details

Version
1.5.7
Published
2025-11-28
Updated
2025-11-28
Namespace
io.github.yuna0x0
Source
yuna0x0/hackmd-mcp

Similar ai & agents servers