HackMD
Enables interaction with HackMD via its API to manage personal and team notes. It supports listing, reading, creating, updating, and deleting notes, as well as accessing user history and profile information.
What is HackMD?
HackMD is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to enables interaction with hackmd via its api to manage personal and team notes. it supports listing, reading, creating, updating, and deleting notes, as well as accessing user history and profile infor...
Enables interaction with HackMD via its API to manage personal and team notes. It supports listing, reading, creating, updating, and deleting notes, as well as accessing user history and profile information.
This server falls under the Knowledge & Memory category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- Enables interaction with HackMD via its API to manage person
Use Cases
Maintainer
Works with
Installation
NPM
npx -y hackmd-mcpManual Installation
npx -y hackmd-mcpConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use HackMD
The HackMD MCP server connects AI assistants directly to HackMD's collaborative markdown note platform via its official API, enabling full lifecycle management of personal and team notes through natural language. It supports listing, reading, creating, updating, and deleting notes across both personal workspaces and team spaces, as well as retrieving user history and profile information. Writers, developers, and technical teams use it to let Claude draft, update, and organize HackMD documentation without manually copying content between the editor and the AI assistant.
Prerequisites
- Node.js 18+ with npm installed
- A HackMD account (free or paid) at https://hackmd.io
- A HackMD API token generated from your account settings at https://hackmd.io/settings#api
- An MCP-compatible client such as Claude Desktop or Claude Code
Generate a HackMD API token
Log in to HackMD, go to Settings > API, and generate a new personal API token. Copy the token — you will need it in the next step.
Add the server to your MCP client config
Edit your claude_desktop_config.json to register hackmd-mcp and set your API token as the HACKMD_API_TOKEN environment variable.
{
"mcpServers": {
"hackmd": {
"command": "npx",
"args": ["-y", "hackmd-mcp"],
"env": {
"HACKMD_API_TOKEN": "your_api_token_here"
}
}
}
}Restart Claude Desktop
Fully quit and reopen Claude Desktop to load the HackMD server. On macOS the config is at ~/Library/Application Support/Claude/claude_desktop_config.json.
Verify the connection
Ask Claude to call get_user_info or list the teams you belong to. A successful response confirms the API token is valid and the server is connected.
Start managing notes
Use natural language to list, read, create, update, or delete notes in your personal workspace or team spaces.
HackMD Examples
Client configuration
Full claude_desktop_config.json entry with the required API token.
{
"mcpServers": {
"hackmd": {
"command": "npx",
"args": ["-y", "hackmd-mcp"],
"env": {
"HACKMD_API_TOKEN": "your_hackmd_api_token",
"HACKMD_API_URL": "https://api.hackmd.io/v1"
}
}
}
}Prompts to try
Example prompts for HackMD note management.
- "List all my HackMD notes and summarize their titles"
- "Show me all the teams I'm part of and list the notes in the first team"
- "Create a new note titled 'Sprint Retrospective 2026-06' with a table of what went well and what to improve"
- "Update my note about the API design to add a new section on authentication"
- "Delete all draft notes that have not been edited in the past 30 days"Troubleshooting HackMD
Authentication error: 401 Unauthorized
Your HACKMD_API_TOKEN is invalid or has been revoked. Generate a new token at https://hackmd.io/settings#api and update the value in your claude_desktop_config.json, then restart Claude Desktop.
Team notes are not visible when listing
Confirm your HackMD account belongs to the team. Use the list_teams tool to see which teams Claude can see, then use list_team_notes with the correct team path.
Rate limiting errors when processing many notes
HackMD's API enforces request rate limits. Space out bulk operations by asking Claude to process notes in smaller batches rather than all at once.
Frequently Asked Questions about HackMD
What is HackMD?
HackMD is a Model Context Protocol (MCP) server that enables interaction with hackmd via its api to manage personal and team notes. it supports listing, reading, creating, updating, and deleting notes, as well as accessing user history and profile information. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install HackMD?
Install via npm with the command: npx -y hackmd-mcp. Then add the server configuration to your AI client's JSON config file (e.g., claude_desktop_config.json or .cursor/mcp.json).
Which AI clients work with HackMD?
HackMD works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is HackMD free to use?
Yes, HackMD is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.
HackMD Alternatives — Similar Knowledge & Memory Servers
Looking for alternatives to HackMD? Here are other popular knowledge & memory servers you can use with Claude, Cursor, and VS Code.
MemPalace
★ 52.6kA local AI memory system that stores all conversations verbatim and organizes them into navigable structures. It provides 19 MCP tools for AI assistants to search and retrieve past decisions, debugging sessions, and architecture debates automatically
Kratos
★ 25.7k🏛️ Memory System for AI Coding Tools - Never explain your codebase again. MCP server with perfect project isolation, 95.8% context accuracy, and the Four Pillars Framework.
Context Mode
★ 15.4kAn MCP server that preserves LLM context by intercepting large data outputs and returning only concise summaries or relevant sections. It enables efficient sandboxed code execution, file processing, and documentation indexing across multiple programm
Memu
★ 13.7kMemory for 24/7 proactive agents like OpenClaw.
MemOS
★ 9.3kMemOS (Memory Operating System) is a memory management operating system designed for AI applications. Its goal is: to enable your AI system to have long-term memory like a human, not only remembering what users have said but also actively invoking, u
Everos
★ 5.4kBuild, evaluate, and integrate long-term memory for self-evolving agents.
Browse More Knowledge & Memory MCP Servers
Explore all knowledge & memory servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up HackMD in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use HackMD?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.