create_note
Create a new note
LABSCO SUMMARY
A shared note becomes somewhere the agent writes, not a link you paste into.
Personal and team notes get identical treatment, so a draft can start in your own space and its team copy be updated in the same session without changing tools. The surface is deliberately narrow — notes, teams, user, history — which makes it a document store you can rely on rather than a wiki you have to learn.
What it is
Twelve tools over the HackMD API: the same four note operations for personal notes and for team notes, plus the account's teams, its user details and its reading history.
What you get
- Personal notes listed, read by noteId, created, updated and deleted
- Team notes given the identical set, addressed by teamPath
- The teams the authenticated account can reach
- The authenticated user's own details
- The account's reading history
Requirements
A HackMD account and an API token in HACKMD_API_TOKEN. Node on your PATH.
Setup effort
Add the configuration to your client
USE CASES
01
Publishing a draft to the team
Find the team, create the note in it, and keep editing it in place. The team path is the only thing that differs from working in your own space.
02
Keeping a running document current
Read the note by ID, write the new version back, and check what else you own without leaving the session it was written in.
03
Finding the note you were reading last week
Reading history gives back what the account opened, which is the fastest route to a note whose title you cannot remember.
12 tools
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
create_team_note
Create a new note in a team
delete_note
Delete a note
delete_team_note
Delete a note in a team
get_history
Get user's reading history
get_note
Get a note by its ID
get_user_info
Get information about the authenticated user
list_team_notes
List all notes in a team
list_teams
List all teams accessible to the user
list_user_notes
List all notes owned by the user
update_note
Update an existing note
update_team_note
Update an existing note in a team
BEFORE YOU INSTALL
What to know first
Tools you get
12 tools when we connected. Create, update and delete exist for both personal and team notes. Over HTTP, a Hackmd-Api-Token header overrides the server's own HACKMD_API_TOKEN.
Requires
- npx on PATH
- Node.js 18+
Where it runs
Both documented clients run the server on your machine.
CONTEXT COST
Light Standing cost
Rated by the size of the 12 tool definitions that ride along on every turn, not by how many there are
INSTALLATION
Connect your client
MCP Clients
Claude Desktop, Any MCP client
JSON
{
"mcpServers": {
"hackmd": {
"command": "npx",
"args": [
"-y",
"hackmd-mcp"
],
"env": {
"HACKMD_API_TOKEN": "<YOUR_HACKMD_API_TOKEN>"
}
}
}
}
