What it does
collabnotes connects to HackMD, a collaborative notes service. It reads the authenticated user's profile, teams and reading history, lists team and personal notes, and creates, updates and deletes notes in both places. It calls the public HackMD API v1 using a personal API token that the user supplies. The package is a clean-room rebuild covering the full documented set of 12 tools from the original HackMD MCP server.
Use it when an MCP-compatible client or a script needs to work with HackMD notes. The tools cover user information, team membership, reading history, and listing, creating, updating and deleting notes for both teams and the individual user, plus fetching a single note by ID. The same tools are also available from a command-line interface, with one subcommand per tool that takes its arguments as a single JSON object.
The `mcp` subcommand starts a stdio MCP server that is registered in an MCP client's configuration. The container image runs the MCP server by default, and passing CLI arguments switches it to CLI mode. Every tool requires the HACKMD_API_TOKEN setting, and calls fail with an error naming that variable before any request is sent. Requests use bearer authorization, and path segments such as team paths and note IDs are URL-encoded. Responses are returned as parsed JSON. Delete calls and empty responses return a status of ok with the IDs involved, and upstream HTTP errors are reported with their status and body.
Limitations and requirements
A HackMD API personal token is required, supplied through HACKMD_API_TOKEN; every tool call fails without it. Note creation and update send only title and content, and update sends only content, because the HackMD API's permission fields are not part of this tool spec.
Safety
Our team has not reviewed this resource. Only automated rules checked it; resources with high-risk signals are not published. These are signals, not a guarantee that installing it is safe. Try it in a sandbox project first.
- Runs code or changes an assistant's behaviour
Sources
- Official MCP Registry first seen 13 Nov 2026 · last seen 13 Nov 2026 · its page on the source
io.github.CloudCorpRecords/collabnotes
Collaborative notes via HackMD: user, team, and personal notes with full CRUD.
v0.1.0As shown on registry.modelcontextprotocol.io when we last read it