Connect HackMD to your AI agent
HackMD is a collaborative Markdown workspace for creating, organizing, and sharing personal and team notes.
We set up the connection using your own HackMD account, with keys you control, and keep it running. Your agent picks it up and starts doing the work.
What your agent can do in HackMD
Each one is a real action the agent can take on its own, the same things a person clicking around HackMD could do. Read-only by default; write actions are confirmed against your policy.
- 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 doc…
- 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.
How we connect it
- 1
Connect your account
You create a key in HackMD, a key you create and control, and paste it in once. It lives in a secrets store on your server, not with us.
- 2
Set the guardrails
Read-only by default. You choose which write actions the agent may take, and anything outside that policy gets confirmed with you first.
- 3
We keep it running
Health checks on every connection, updates handled for you, and we watch the first week of activity to make sure the work lands.
FAQ
HackMD questions, answered.
Ready to put HackMD to work?
Tell us what your team runs on. We set up the connection, secure it, and your agent takes it from there.
All product names, logos, and brands are property of their respective owners; used for identification only. ZeroToClaw is not affiliated with or endorsed by HackMD.