HackMD MCP server

This is a small helper that connects your AI assistant to HackMD, the place where you keep your shared notes. Once it is set up, you can just ask your AI in plain words to look at your notes, write a new one, or update an existing one. It is handy if you already use HackMD for meeting notes, drafts, or team documents and want to skip the copy and paste.

What this MCP server does

You ask your AI something about your HackMD notes. The AI sends that request to this helper program running on your computer or in the cloud. The helper signs in to HackMD with a special token that belongs to your account. It then fetches, creates, or changes notes and teams as you asked. Finally, it sends the result back, and your AI shows it to you in the chat.

Click to zoom

What you can do with it

• List all the notes you own in HackMD
• Read a specific note by its name or ID
• Create a new note with a title and content
• Update the text of an existing note
• Delete a note you no longer need
• List the teams you belong to and the notes inside them
• See your reading history in HackMD

Try asking your AI

• “List all my HackMD notes.”
• “Create a new note called Meeting Notes with these bullet points.”
• “Show me the notes in my first team.”
• “Update my Project Plan note and add a section called Next Steps.”

What it gives back to you

You get back plain answers in the chat, like a list of note titles, the text of a note, or a short confirmation that a note was created or changed. When you ask for a list, you see the names and IDs so you can pick one. When you ask for a change, the AI usually tells you what it did.

Before you start

Who it's for

People who already keep notes and team documents in HackMD and want their AI to read or write them without switching windows.