HackMD MCP Server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@HackMD MCP Server list my most recent HackMD notes"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
██╗ ██╗ █████╗ ██████╗██╗ ██╗███╗ ███╗██████╗
██║ ██║██╔══██╗██╔════╝██║ ██╔╝████╗ ████║██╔══██╗
███████║███████║██║ █████╔╝ ██╔████╔██║██║ ██║
██╔══██║██╔══██║██║ ██╔═██╗ ██║╚██╔╝██║██║ ██║
██║ ██║██║ ██║╚██████╗██║ ██╗██║ ╚═╝ ██║██████╔╝
╚═╝ ╚═╝╚═╝ ╚═╝ ╚═════╝╚═╝ ╚═╝╚═╝ ╚═╝╚═════╝
@zyx1121/hackmd-mcp
MCP server for HackMD — list, read, create, update, and delete notes via Claude Code.
Setup
1. Get API Token
Log in to HackMD
Go to Settings → API
Click Create API token, and give it a name
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 current user profile |
| List all notes |
| Get a note (with content) |
| Create a new note |
| Update content or permissions |
| Delete a note |
| Get reading history |
| List teams |
| List notes of a team |
| Create a note in a team |
| Update a team note |
| Delete a team note |
License
MIT — Note to self.
Available Tools
12 toolscreate_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
Scored across 12 tools
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.
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.
12 tools is an ideal scope for a note-taking server, covering both personal and team workflows without unnecessary bloat or deficiency.
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
Interact with your HackMD notes and teams seamlessly. Manage your notes, view reading history, and…
Read and write the notes and folders of your Grape account, the AI note-taking app.
Create, search and manage Knowtis collaborative notes from AI assistants.
Search, retrieve, create, and update visual knowledge maps in a user's KnowMapped account.