Hackmd MCP Server

by yuna0x0ai.smithery/yuna0x0-hackmd-mcpv1.5.3

Interact with your HackMD notes and teams seamlessly. Manage your notes, view reading history, and…

68Node.jsstdioremoteofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Maintained3mo ago

Install Hackmd MCP server

claude mcp add ai-smithery-yuna0x0-hackmd-mcp -e HACKMD_API_TOKEN='<hackmd-api-token>' -- npx -y hackmd-mcp

{
  "mcpServers": {
    "ai-smithery-yuna0x0-hackmd-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "hackmd-mcp"
      ],
      "env": {
        "HACKMD_API_TOKEN": "<hackmd-api-token>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "ai-smithery-yuna0x0-hackmd-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "hackmd-mcp"
      ],
      "env": {
        "HACKMD_API_TOKEN": "<hackmd-api-token>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "ai-smithery-yuna0x0-hackmd-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "hackmd-mcp"
      ],
      "env": {
        "HACKMD_API_TOKEN": "<hackmd-api-token>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "ai-smithery-yuna0x0-hackmd-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "hackmd-mcp"
      ],
      "env": {
        "HACKMD_API_TOKEN": "<hackmd-api-token>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
HACKMD_API_TOKEN	yes	yes	Your HackMD API token for API authentication
HACKMD_API_URL	—	—	Optional HackMD API URL, defaults to https://api.hackmd.io/v1

Remote endpoints

streamable-httphttps://server.smithery.ai/@yuna0x0/hackmd-mcp/mcp

Freshness

Maintained — last maintenance signal 3mo ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-07-13 · 3mo ago · GitHub
Latest release
2025-11-28 · 11mo ago · GitHub · v1.5.7
Package published
no data · npm/PyPI
Registry entry updated
2025-09-29 · 13mo ago · official registry · v1.5.3

FAQ

›How do I install the Hackmd MCP server in Claude Code?

Run: claude mcp add ai-smithery-yuna0x0-hackmd-mcp -e HACKMD_API_TOKEN='<hackmd-api-token>' -- npx -y hackmd-mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Hackmd require an API key?

Yes. It expects HACKMD_API_TOKEN, of which 1 is a secret.

›Can I use Hackmd as a remote (hosted) MCP server?

Yes — it offers both a hosted endpoint and a local stdio package.

›Is Hackmd in the official MCP registry?

Yes, as ai.smithery/yuna0x0-hackmd-mcp.