Productivity · Local MCP server

HackMD

A Model Context Protocol server for integrating HackMD's note-taking platform with AI assistants.

What the MCP Registry states

The entry as published to the official MCP Registry (read 2026-10-04), latest version.

Registry name
io.github.yuna0x0/hackmd-mcp
Version
1.5.7
Status
Active
Category
productivity
Transport
stdio (local process)
Package
npm, OCI image (Docker), MCP Bundle (.mcpb)
Published
2025-11-28
Updated
2025-11-28
Publisher
yuna0x0 (GitHub)
Namespace
Namespace verified by the MCP Registry via GitHub (github.com/yuna0x0) · how
Repository
github.com/yuna0x0/hackmd-mcp
Source
Registry API entry

Packages

RegistryPackageVersionTransportEnvironment variables
npmhackmd-mcp1.5.7stdioHACKMD_API_TOKEN (required, secret), HACKMD_API_URL
OCI image (Docker)ghcr.io/yuna0x0/hackmd-mcp:1.5.7-stdioHACKMD_API_TOKEN (required, secret), HACKMD_API_URL
MCP Bundle (.mcpb)https://github.com/yuna0x0/hackmd-mcp/releases/download/v1.5.7/hackmd-mcp-1.5.7.mcpbSHA-256 checksum stated-stdioHACKMD_API_TOKEN (required, secret), HACKMD_API_URL

How to connect HackMD

HackMD runs locally from a Node.js package published to the npm registry: hackmd-mcp version 1.5.7. It speaks MCP over stdio, so the client starts it as a program and talks to it through standard input and output. It needs Node.js; clients usually start it with npx - the usual command is npx -y hackmd-mcp@1.5.7. It reads these environment variables: HACKMD_API_TOKEN (required, secret) and HACKMD_API_URL; set them in the client's configuration for this server.

HackMD runs locally from a container image in an OCI registry such as Docker Hub or GitHub Container Registry: ghcr.io/yuna0x0/hackmd-mcp:1.5.7. It speaks MCP over stdio, so the client starts it as a program and talks to it through standard input and output. It needs Docker or another OCI container runtime; started with docker run - the usual command is docker run -i --rm -e HACKMD_API_TOKEN -e HACKMD_API_URL ghcr.io/yuna0x0/hackmd-mcp:1.5.7. It reads these environment variables: HACKMD_API_TOKEN (required, secret) and HACKMD_API_URL; set them in the client's configuration for this server.

HackMD runs locally from an MCP Bundle: a single downloadable archive holding a local server and a manifest that describes it: https://github.com/yuna0x0/hackmd-mcp/releases/download/v1.5.7/hackmd-mcp-1.5.7.mcpb. It speaks MCP over stdio, so the client starts it as a program and talks to it through standard input and output. It needs a client that installs MCP Bundles; the file is opened in, or added to, that client. It reads these environment variables: HACKMD_API_TOKEN (required, secret) and HACKMD_API_URL; set them in the client's configuration for this server.

In the mcpServers JSON format that many desktop and editor MCP clients read, the entry looks like this (placeholders in angle brackets):

{
  "mcpServers": {
    "hackmd-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "hackmd-mcp@1.5.7"
      ],
      "env": {
        "HACKMD_API_TOKEN": "<secret>",
        "HACKMD_API_URL": "<value>"
      }
    }
  }
}

Derived from the registry entry, not tested here. What the server does, and on what terms, is set by its publisher; check its repository or website before giving it access to your accounts or files. How to add an MCP server to an assistant · Before you connect

More productivity servers

All 2,706 →
ServerRunsEndpoint or package
GuapuCRM AI-native para PYMEs de LATAM: contactos, ventas, cotizaciones, WhatsApp y métricas vía MCP.Remote · HTTPLive check: ✗ no handshakeguapu.io
GumroadRead products, sales, subscribers and offer codes; verify, enable and disable product licenses.Remote · HTTPLive check: ✓ handshakegumroad.usefulapi.io
GuruPDFConvert, compress & merge PDFs and 100+ file formats from any AI agent. By GuruPDF.Local · stdionpm: gurupdf-mcp
Gws ConnectorMulti-account Google Workspace MCP - Gmail, Calendar, Drive, Sheets, Docs with routing.Local · stdioMCP Bundle (.mcpb): orieg/gws-connector/releases/download/v0.4.3/gws
HailPhone, SMS & email for AI agents - one remote MCP endpoint, OAuth login, zero install.Remote · HTTPLive check: ✓ handshakemcp.hail.so
HairDora Salon SchedulingSee your salon's free slots, appointments, stylists, services, clients, quotes and payments.Remote · HTTPLive check: ✓ handshakemcp.hairdora.com
HaloPSAMCP server for HaloPSA - clients, tickets, and PSA workflows via the HaloPSA REST API.Local · stdioOCI image (Docker): ghcr.io/wyre-ai/halopsa-mcp:v1.7.16
HaloPSAMCP server for HaloPSA - clients, tickets, and PSA workflows via the HaloPSA REST API.Local · stdioOCI image (Docker): ghcr.io/wyre-technology/halopsa-mcp:v1.7.11