# HackMD — MCP server on mcp.ai
> Connect your HackMD account and use 8 tools for documents straight from your AI agent. Connect with your own API key. HackMD is a collaborative Markdown workspace for creating, organizing, and sharing personal and team notes.

By: mcp.ai · official
Page: https://mcp.ai/hackmd

## Connect (MCP protocol)
Remote MCP endpoint (HTTP, streamable): https://api.mcp.ai/p_hackmd?ms=1787291520000
Add it as a custom/remote MCP connector, then authenticate when prompted.

## REST API (no MCP client required)
Every tool is also a REST endpoint, authed with a workspace API key.
Discover: GET https://api.mcp.ai/api/hackmd/_endpoints   # public; lists every endpoint
Call:     POST https://api.mcp.ai/api/hackmd/<endpoint>
  Authorization: Bearer sk_live_…   # create one at https://mcp.ai/settings/api-keys
  Content-Type: application/json
  Body: { …args }   →   { "ok": true, "tool": "<id>", "result": { … } }

## Developer docs
How to use (MCP or REST), markdown: https://mcp.ai/hackmd/skill.md
Postman collection (v2.1): https://mcp.ai/hackmd/postman.json

## Tools
- hackmd_create_note(tags?: string[], title?: string, content?: string, team_path?: string, description?: string, read_permission?: string, parent_folder_id?: string, write_permission?: string, comment_permission?: string, suggest_edit_permission?: string) — Create a Markdown note in the personal workspace or a specified team workspace. The team branch is documented but was not live-tested because the test account belongs to no teams.
- hackmd_get_account() — Return the HackMD profile for the connected token and the teams visible to it. Use the returned team paths with tools that accept team_path.
- hackmd_get_note(note_id: string) — Get a note by ID, including its Markdown content. The personal note route can also retrieve an accessible team note, so no team selector is needed.
- hackmd_list_folders(team_path?: string) — List all folders in the personal workspace, or in one team workspace when team_path is supplied. Use a folder ID as parent_folder_id when creating a note. The team route is documented but was not live
- hackmd_list_notes(team_path?: string) — List all notes in the personal workspace, or in one team workspace when team_path is supplied. HackMD returns the complete collection without pagination; the team route is documented but was not live-
- hackmd_list_trash() — List soft-deleted notes in the personal workspace. Team trash is intentionally excluded because it requires team-admin permission and could not be live-tested.
- hackmd_move_note_to_trash(note_id: string, team_path?: string) — Soft-delete a note by moving it to trash in the personal workspace or an explicitly selected team workspace. This is not permanent deletion. Personal notes can be restored with HACKMD_RESTORE_NOTES; t
- hackmd_restore_notes(note_ids: string[]) — Restore one or more personal notes from HackMD trash. Returns a per-note success or failure outcome so a partial HTTP 207 result is never reported as an unconditional success.

## Example prompts
- "What can I do in HackMD?"
- "Show me a summary of my HackMD account"

## Links
Docs: https://mcp.ai/docs/mcps/hackmd
Website: https://mcp.ai/mcps/hackmd