HackMD
HackMD is a collaborative Markdown workspace for creating, organizing, and sharing personal and team notes.
Integration
- Vendor
- HackMD
- Category
- docs
- Auth
- API_KEY
- Tools
- 8
- Composio slug
hackmd
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
- Create or open a Switchy Project.
- Open Integrations and connect HackMD.
- Authorise through api_key. Switchy stores the connection against your org.
- Everyone in the Project can now @-mention the HackMD tools in chat.
What teammates see: by default, memories from HackMD are scoped to the Project (PROJECT visibility) - you can mark any memory PRIVATE or share it ORG-wide.
Works well with
Top models
Compatibility data appears once enough Projects have used this MCP together with a given model.