What is the HackMD MCP server?
A Model Context Protocol server for integrating HackMD's note-taking platform with AI assistants.
How to install HackMD
Copy-paste configuration for popular MCP clients.
transport: stdio
Config generated by PluginBench — verify against the source before use.Environment / auth
HACKMD_API_TOKENrequiredsecretYour HackMD API token for API authentication
HACKMD_API_URLOptional HackMD API URL, defaults to https://api.hackmd.io/v1
Claude Desktop
~/Library/Application Support/Claude/claude_desktop_config.json
{
"mcpServers": {
"hackmd-mcp": {
"command": "npx",
"args": [
"-y",
"hackmd-mcp"
],
"env": {
"HACKMD_API_TOKEN": "<YOUR_HACKMD_API_TOKEN>",
"HACKMD_API_URL": "<YOUR_HACKMD_API_URL>"
}
}
}
}Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"hackmd-mcp": {
"command": "npx",
"args": [
"-y",
"hackmd-mcp"
],
"env": {
"HACKMD_API_TOKEN": "<YOUR_HACKMD_API_TOKEN>",
"HACKMD_API_URL": "<YOUR_HACKMD_API_URL>"
}
}
}
}Windsurf
~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"hackmd-mcp": {
"command": "npx",
"args": [
"-y",
"hackmd-mcp"
],
"env": {
"HACKMD_API_TOKEN": "<YOUR_HACKMD_API_TOKEN>",
"HACKMD_API_URL": "<YOUR_HACKMD_API_URL>"
}
}
}
}VS Code
.vscode/mcp.json
{
"servers": {
"hackmd-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"hackmd-mcp"
],
"env": {
"HACKMD_API_TOKEN": "<YOUR_HACKMD_API_TOKEN>",
"HACKMD_API_URL": "<YOUR_HACKMD_API_URL>"
}
}
}
}Claude Code
claude mcp add hackmd-mcp --env HACKMD_API_TOKEN=<YOUR_HACKMD_API_TOKEN> --env HACKMD_API_URL=<YOUR_HACKMD_API_URL> -- npx -y hackmd-mcp