HackMD for AI agents
Agents read HackMD at once. Changes and sends are held for a person's approval by default.
About HackMD
HackMD is a collaborative Markdown workspace for creating, organizing, and sharing personal and team notes.
What an agent can do in HackMD
Every HackMD action is classed by the platform as a read, a change or a send. Reads run at once. Changes and sends are held for a person by default.
Runs at once (reads)
Looks things up in HackMD without asking first. 5 actions.
- Get AccountReturn 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 NoteGet 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 FoldersList 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
- List NotesList 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-
- List TrashList soft-deleted notes in the personal workspace. Team trash is intentionally excluded because it requires team-admin permission and could not be live-tested.
Held for approval by default (changes and sends)
Held for a person's approval by default. The approval is recorded and the action is sent once, never twice, with 10 seconds to undo. 3 actions.
- Create NoteCreate 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.
- Move Note to TrashSoft-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
- Restore NotesRestore 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.
Changes wait in Needs you
Changes and sends in HackMD are held for a person's approval by default. The approval is recorded, and the action is sent once, never twice, with 10 seconds to undo.
Related connectors
HackMD questions
Can an agent change data in HackMD on its own?
Not by default. Changes and sends in HackMD are held for a person's approval. The approval is recorded, and the action is sent once, never twice, with 10 seconds to undo.
What can an agent read in HackMD?
This connector lists 5 read actions. Reads run at once, without waiting for approval.
How does HackMD connect?
It connects with API key. Connectors are built and maintained by third-party developers; availability is confirmed during scoping.