HackMD MCP Server: Install & Setup

Install HackMD in Claude Code

Remote URL

Claude Code

claude mcp add --transport http hackmd https://server.smithery.ai/@yuna0x0/hackmd-mcp/mcp

mcp.json (Claude Desktop, Cursor, VS Code, Windsurf)

{
  "mcpServers": {
    "hackmd": {
      "url": "https://server.smithery.ai/@yuna0x0/hackmd-mcp/mcp"
    }
  }
}

npm

Claude Code

claude mcp add hackmd -e HACKMD_API_TOKEN=... -- npx -y hackmd-mcp

mcp.json (Claude Desktop, Cursor, VS Code, Windsurf)

{
  "mcpServers": {
    "hackmd": {
      "command": "npx",
      "args": [
        "-y",
        "hackmd-mcp"
      ],
      "env": {
        "HACKMD_API_TOKEN": "..."
      }
    }
  }
}

Docker

Claude Code

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

mcp.json (Claude Desktop, Cursor, VS Code, Windsurf)

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

MCP Bundle (.mcpb)

Claude Code

curl -LO https://github.com/yuna0x0/hackmd-mcp/releases/download/v1.5.7/hackmd-mcp-1.5.7.mcpb

mcp.json (Claude Desktop, Cursor, VS Code, Windsurf)

Download hackmd-mcp-1.5.7.mcpb and double-click it to install in Claude Desktop.

MCP Bundles install in one click in Claude Desktop. Download the file, then open it.

Replace each ... with your own value.

Frequently asked questions

What does the HackMD MCP server do?

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

Is the HackMD MCP server free?

The server is free, but you will likely need an account. The server itself is free, but it connects to a service that needs an account or API key, which may have paid tiers. Check the provider for current pricing.

Does HackMD run locally or remotely?

Local + Remote. Can run locally or be used as a hosted remote server.

How do I add HackMD to Claude Code?

Run: claude mcp add --transport http hackmd https://server.smithery.ai/@yuna0x0/hackmd-mcp/mcp

More other tools & integrations MCP servers

View all

jDataMunch

jgravelle/jdatamunch-mcp

Tabular data retrieval. Index CSV/Excel, query rows, aggregate. 99%+ savings vs raw file reads.

LocalFree

OpenAI

pierrebrunelle/mcp-server-openai

Query OpenAI models directly from Claude using MCP protocol

LocalAccount neededPython

Skill of Skills

the911fund/skill-of-skills

Quality-ranked, cross-platform directory of AI coding skills, plugins and MCP servers.

RemoteAccount needed

arr

bardesss/arr-mcp

One server, 40 tools, the whole media stack: arrs, Jellyfin, Plex, Seerr, Cleanuparr, downloaders

LocalFree

Perigee

42.3k

dlamarre-dev/Perigee

Positions, distances, mission facts and 3D views of objects orbiting the Earth, Moon, Mars and Sun.

Local + RemoteFree

Orcaslicer

MaxEllis/orcaslicer-mcp

Drive a running OrcaSlicer 3D-printing slicer: load models, tune settings, slice, compare variants and render the plate, with an offline settings reference.

LocalAccount neededPython