Connect Codex to HackMD
Set up in minutes
Choose where it runs
On your computer through your own Codex, or hosted in the cloud. The rest of setup adapts to your choice:
Pick what it can do in HackMD
A preset of real HackMD operations. Each one becomes a tool the agent can call, and it can't touch anything outside the list.
Connect HackMD
One sign-in. The agent acts through your account, scoped to the operations you picked.
Add your personal MCP link
The last step mints a private MCP URL for this agent and walks you through exactly this, with your real link filled in. The page flips to Connected the moment your Codex first calls in. Codex connects when a session starts — run codex, or restart a running one (in the Codex app, Restart).
Run this in your terminal. The Codex app shares its config, so it gets the server too
<your-link> is your personal server URL — setup mints it for you.
Tools Codex gets
HackMD
20 toolsGet me using the corresponding HackMD v1 endpoint.
List notes using the corresponding HackMD v1 endpoint.
Get note using the corresponding HackMD v1 endpoint.
Create note using the corresponding HackMD v1 endpoint.
Update note using the corresponding HackMD v1 endpoint.
Delete note using the corresponding HackMD v1 endpoint.
List teams using the corresponding HackMD v1 endpoint.
List team notes using the corresponding HackMD v1 endpoint.
Get team note using the corresponding HackMD v1 endpoint.
Create team note using the corresponding HackMD v1 endpoint.
Update team note using the corresponding HackMD v1 endpoint.
Delete team note using the corresponding HackMD v1 endpoint.
Get history using the corresponding HackMD v1 endpoint.
List folders using the corresponding HackMD v1 endpoint.
Get folder using the corresponding HackMD v1 endpoint.
Create folder using the corresponding HackMD v1 endpoint.
Update folder using the corresponding HackMD v1 endpoint.
Delete folder using the corresponding HackMD v1 endpoint.
List trash using the corresponding HackMD v1 endpoint.
Restore note using the corresponding HackMD v1 endpoint.
About Codex
Frequently asked questions
More ways to connect
Open your Codex agent in one click.
NoClick runs Codex for you with HackMD wired in as tools. Connect your account and run.