A Model Context Protocol server that lets AI assistants access the HackMD REST API (user info, notes, teams, etc.).
https://github.com/yuna0x0/hackmd-mcpStop switching between your AI chat and HackMD. This MCP server gives Claude, ChatGPT, and other AI assistants direct access to your HackMD notes, letting you manage your entire knowledge base without leaving your AI workflow.
You're deep in a conversation with your AI assistant, working through a complex problem. You want to reference that architecture decision you documented last month, or save the current discussion to your team's project notes. Instead of opening HackMD, copying content back and forth, and losing your train of thought - your AI can handle it directly.
The hackmd-mcp server bridges this gap by exposing HackMD's full API through the Model Context Protocol. Your AI assistant can now:
Instant Note Access: Ask your AI to "find my notes about Docker deployment" and get results immediately. No more manually searching through dozens of notes.
Seamless Documentation: Having a technical discussion? Tell your AI to "save this conversation to my DevOps team notes" and it handles the formatting and organization.
Smart Content Management: Your AI can read your existing notes, understand the context, and suggest updates or related content based on your current conversation.
Team Collaboration: Manage team notes, create shared documentation, and keep everyone's knowledge base current - all through natural language commands to your AI.
Research and Learning: You're exploring a new technology stack. Your AI can search your existing notes for related concepts, create new learning documents, and organize insights as you discover them.
Project Management: During sprint planning, your AI can pull up previous retrospective notes, create new project documentation, and update team wikis with decisions made in your conversation.
Technical Writing: Writing documentation? Your AI can reference your existing notes, suggest content based on similar documents, and maintain consistency across your knowledge base.
Code Review Prep: Before a big review, your AI can search your notes for coding standards, pull up architecture decisions, and create review checklists based on your team's documented practices.
The fastest way to connect your AI to HackMD:
# Install via Smithery (recommended)
npx -y @smithery/cli install @yuna0x0/hackmd-mcp --client claude
# Or use mcp-get
npx @michaellatman/mcp-get@latest install hackmd-mcp
You'll need your HackMD API token (grab it from your HackMD settings), and you're ready to go.
For manual setup or custom configurations, the repository includes clear installation instructions and Docker support for containerized deployments.
This isn't just another API wrapper. The server includes:
The developer experience is smooth because it handles the complexity of HackMD's API while exposing simple, natural language commands to your AI assistant.
Instead of treating your notes as static documents, this MCP server turns them into an active part of your AI-powered workflow. Your entire HackMD knowledge base becomes searchable, editable, and manageable through conversation.
The 24 stars and active development show this is solving a real problem for developers who want their AI assistants to work with their existing documentation workflows, not against them.
Ready to eliminate the context switching between your AI and your notes? Clone the repository and connect your AI assistant to HackMD in the next five minutes.