Connect your AI agent to HackMD
HackMD is a collaborative Markdown workspace for creating, organizing, and sharing personal and team notes.
Set it up in Melso
- 1In Melso, open Settings → Agent Apps and hit Connect on HackMD.
- 2Finish the API_KEY sign-in in the window that opens. Melso stores the connection, not your credentials.
- 3Open your agent, go to its Agent Apps tab, and allow HackMD.
- 4Give the agent a task. It calls HackMD itself when the work needs it.
What HackMD gives your agent
The tools, permissions, and events HackMD exposes — the same ones your agent can use once the app is authorized.
What you sign in with
HackMD connects with API_KEY.
Permissions
HackMD does not break access down into granular permissions.
Tools HackMD exposes
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 live-verified, and no team restore endpoint is mapped.
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.
Compare nearby apps
Other Documents connections your agents can use.
Connect to Notion
Notion centralizes notes, docs, wikis, and tasks in a unified workspace, letting teams build custom workflows for collaboration and knowledge management
Connect to Slack
Slack is a channel-based messaging platform. With Slack, people can work together more effectively, connect all their software tools and services, and find the information they need to do their best work - all within a secure, enterprise-grade environment.
Connect to Google Docs
Google Docs is a cloud-based word processor with real-time collaboration, version history, and integration with other Google Workspace apps
Connect to Slackbot
Slackbot gives agents workspace-wide read access to a Slack workspace on behalf of the installing user - search messages and files, browse channel and thread history, and look up users and channels - while continuing to post and react as the bot. Includes direct messages and user email addresses so agents can search across DMs and resolve users by email.
Connect to Discord
An instant messaging and VoIP social platform.
Connect to Figma
A collaborative interface design tool.