Skip to main content
Glama
██╗  ██╗ █████╗  ██████╗██╗  ██╗███╗   ███╗██████╗ 
██║  ██║██╔══██╗██╔════╝██║ ██╔╝████╗ ████║██╔══██╗
███████║███████║██║     █████╔╝ ██╔████╔██║██║  ██║
██╔══██║██╔══██║██║     ██╔═██╗ ██║╚██╔╝██║██║  ██║
██║  ██║██║  ██║╚██████╗██║  ██╗██║ ╚═╝ ██║██████╔╝
╚═╝  ╚═╝╚═╝  ╚═╝ ╚═════╝╚═╝  ╚═╝╚═╝     ╚═╝╚═════╝ 
                                                   

@zyx1121/hackmd-mcp

MCP server for HackMD — list, read, create, update, and delete notes via Claude Code.

Setup

1. Get API Token

  1. Log in to HackMD

  2. Go to Settings → API

  3. Click Create API token, and give it a name

  4. Copy the token (you won't be able to see it again after closing the window)

2. Configure MCP

{
  "mcpServers": {
    "hackmd": {
      "command": "npx",
      "args": ["-y", "@zyx1121/hackmd-mcp"],
      "env": {
        "HACKMD_API_TOKEN": "your-token-here"
      }
    }
  }
}

Tools

Tool

Description

get_me

Get current user profile

list_notes

List all notes

get_note

Get a note (with content)

create_note

Create a new note

update_note

Update content or permissions

delete_note

Delete a note

get_history

Get reading history

list_teams

List teams

list_team_notes

List notes of a team

create_team_note

Create a note in a team

update_team_note

Update a team note

delete_team_note

Delete a team note

License

MIT — Note to self.

Available Tools

12 tools
create_noteC

Create a new note

Inputs: title, content, read_permission, write_permission, +2 more.

create_team_noteC

Create a note in a team

Inputs: team_path (required), title, content, read_permission, +2 more.

delete_noteC

Delete a note

Inputs: note_id (required).

delete_team_noteC

Delete a team note

Inputs: team_path (required), note_id (required).

get_historyC

Get reading history

Inputs: no named parameters.

get_meA

Get current user profile

Inputs: no named parameters.

get_noteA

Get a note by ID (returns full content)

Inputs: note_id (required).

list_notesB

List all notes of the current user

Inputs: no named parameters.

list_team_notesC

List notes of a team

Inputs: team_path (required).

list_teamsB

List teams the user belongs to

Inputs: no named parameters.

update_noteB

Update a note's content or permissions

Inputs: note_id (required), content, read_permission, write_permission, +1 more.

update_team_noteC

Update a team note

Inputs: team_path (required), note_id (required), content, read_permission, +2 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.4/5.0

    Scored across 12 tools

    Disambiguation5/5

    Each tool targets a clear and distinct resource (personal note vs. team note, history, user, team) with well-defined actions, so agents can easily differentiate them.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern in snake_case (e.g., create_note, list_teams, update_team_note), with no mixing of conventions.

    Tool Count5/5

    12 tools is an ideal scope for a note-taking server, covering both personal and team workflows without unnecessary bloat or deficiency.

    Completeness5/5

    The tool set provides full CRUD for personal and team notes, plus listing, history, user profile, and team management, leaving no obvious gaps for core note-taking operations.

    Related MCP Connectors