HackMD MCP Server

A Model Context Protocol (MCP) server that interfaces with the HackMD API, allowing LLM clients to access and interact with HackMD notes, teams, user profiles, and history data.

Local serverstdioMIT

What is the HackMD MCP Server?

hackmd-mcp is an MCP project maintained in the yuna0x0/hackmd-mcp repository. The maintainer describes its purpose as “A Model Context Protocol (MCP) server that interfaces with the HackMD API, allowing LLM clients to access and interact with HackMD notes, teams, user profiles…”. Read the project documentation for the complete scope.

Installation

The documented npm package is hackmd-mcp. The configuration below comes from the maintainer’s example; adapt its paths and account values to your environment.

Configuration values

The example declares HACKMD_API_TOKEN. Secret-looking values have been replaced with placeholders. Required and optional labels are shown only when the documentation states them.

Source

Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
get_user_infoGet information about the authenticated user
list_teamsList all teams accessible to the user
get_historyGet user's reading history
list_team_notesList all notes in a team
create_team_noteCreate a new note in a team
update_team_noteUpdate an existing note in a team
delete_team_noteDelete a note in a team
list_user_notesList all notes owned by the user
get_noteGet a note by its ID
create_noteCreate a new note
update_noteUpdate an existing note
delete_noteDelete a note

How to install the HackMD MCP Server

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

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

VariableDescriptionRequired
HACKMD_API_TOKENDeclared in the maintainer’s client configuration.Yes