# HackMD MCP

Vendor: HackMD  
Category: docs  
Auth: API_KEY  
Composio slug: `hackmd`

HackMD is a collaborative Markdown workspace for creating, organizing, and sharing personal and team notes.

## Tools

- **Create Note** — 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.
- **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.
- **Get Note** — 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.
- **List Folders** — 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-tested.
- **List Notes** — 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-tested.
- **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.
- **Move Note to Trash** — 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; team deletion is documented but was not l
- **Restore Notes** — 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.

## Setup

1. Create or open a Switchy Project.
2. Open Integrations and connect HackMD.
3. Authorise through api_key.
4. Teammates can now @-mention HackMD tools in chat.

---
Last verified: 2026-09-04T02:00:56.012Z  
Canonical URL: https://switchy.build/directory/mcps/hackmd