HackMD

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

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

Runs on your machineLocal
Category
Cloud and DevOps
Connection
Local (npm)
Tools
Shown after install
Status
Runs on your computer

Connect it to your AI

Claude Code (npm)

claude mcp add hackmd-mcp -e HACKMD_API_TOKEN=… -- npx -y hackmd-mcp@1.5.7

Needs: HACKMD_API_TOKEN

Claude Code (Docker)

claude mcp add hackmd-mcp -e HACKMD_API_TOKEN=… -- docker run -i --rm ghcr.io/yuna0x0/hackmd-mcp:1.5.7

Needs: HACKMD_API_TOKEN

Cursor, VS Code and other apps (mcp.json)

{
  "mcpServers": {
    "hackmd-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "hackmd-mcp@1.5.7"
      ]
    }
  }
}

Questions

What is the HackMD MCP server?

A Model Context Protocol server for integrating HackMD's note-taking platform with AI assistants. It is made by @yuna0x0 and listed in the official MCP Registry as io.github.yuna0x0/hackmd-mcp. MCP (Model Context Protocol) is the open standard that lets AI apps like Claude, ChatGPT and Cursor use outside tools.

How do I add HackMD to Claude?

In Claude Code, run: claude mcp add hackmd-mcp -e HACKMD_API_TOKEN=… -- npx -y hackmd-mcp@1.5.7

How do I add HackMD to ChatGPT?

ChatGPT only connects to remote MCP servers, and HackMD runs on your own computer. Use it from Claude, Cursor or another app that runs local servers.

How do I add HackMD to Cursor?

Open Cursor settings, go to MCP, choose "Add new MCP server" (or edit ~/.cursor/mcp.json) and add: { "mcpServers": { "hackmd-mcp": { "command": "npx", "args": [ "-y", "hackmd-mcp@1.5.7" ] } } }

Does HackMD work right now?

It runs on your own computer, so it works once you install it. There is no remote server for us to check.

Is this your server? Get the badge for your README
chen.media/mcp badge

Markdown (GitHub README)

[![Listed on chen.media/mcp](https://chen.media/mcp/badge/github-yuna0x0-hackmd-mcp.svg)](https://chen.media/mcp/github-yuna0x0-hackmd-mcp)

HTML (switches to dark mode on its own)

<a href="https://chen.media/mcp/github-yuna0x0-hackmd-mcp"><picture><source media="(prefers-color-scheme: dark)" srcset="https://chen.media/mcp/badge/github-yuna0x0-hackmd-mcp.svg?theme=dark"><img src="https://chen.media/mcp/badge/github-yuna0x0-hackmd-mcp.svg" alt="Listed on chen.media/mcp" height="40"></picture></a>

More in Cloud and DevOps

See all