Model Context Protocol

Hackmd

This MCP server enables LLM clients to interact with HackMD notes, teams, and user data via the HackMD API, supporting both HTTP and STDIO transports.

Connections & Capabilities

Connects To

GitHubDocker

Capabilities

readwrite

Quickstart

Install

npx @modelcontextprotocol/inspector -e HACKMD_API_TOKEN=your_api_token npx hackmd-mcp

Config

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

Exposed MCP Tools (12)

safe

get_user_info

Retrieves information about the currently authenticated HackMD user.

Read-only operation, no data modification.

safe

list_teams

Lists all HackMD teams that the user has access to.

Read-only operation, no data modification.

safe

get_history

Retrieves the user's HackMD reading history.

Read-only operation, no data modification.

safe

list_team_notes

Lists all notes within a specified HackMD team.

Read-only operation, no data modification.

moderate

create_team_note

Creates a new note within a specified HackMD team.

Creates a new resource.

high

update_team_note

Updates an existing note within a specified HackMD team.

Modifies existing data.

critical

delete_team_note

Deletes a note from a specified HackMD team.

Deletes existing data.

safe

list_user_notes

Lists all notes owned by the user.

Read-only operation, no data modification.

safe

get_note

Retrieves a specific note by its ID.

Read-only operation, no data modification.

moderate

create_note

Creates a new note for the user.

Creates a new resource.

high

update_note

Updates an existing note.

Modifies existing data.

critical

delete_note

Deletes a note.

Deletes existing data.