Connect HackMD to your AI agent

Productivity 8 actions available

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. 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. 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. 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.

HackMD questions, answered.

With a key you create and control. You paste it in once, it is stored in a secrets store on your server, permissions are scoped to the minimum the agent needs, and you can revoke it at any time.
The actions HackMD's API allows, the same things a person clicking around the app could do. Connections start read-only by default; write actions are confirmed against the policy you set before the agent takes them.
Connections are priced per tool on top of the base plan. Some are included, some are premium. See pricing for how connection charges work.
Standard tools are ready inside 7 business days of the setup call. We test the connection end to end, walk you through how the agent uses it, and watch the first week of activity.

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.