yuna0x0/hackmd-mcp

Overview

A Model Context Protocol server that connects HackMD's collaborative note-taking platform to AI assistants. It enables reading, creating, and managing HackMD notes through the MCP interface.

Best for

Best for
Developers who want to connect AI assistants to HackMD for note management and retrieval.

Use cases

• Automating note creation and organization in HackMD from an AI assistant
• Retrieving and summarizing existing HackMD notes during a conversation
• Integrating HackMD as a knowledge base for AI-driven workflows

How to use

Install

npx @modelcontextprotocol/inspector -e HACKMD_API_TOKEN=your_api_token npx hackmd-mcp

Tested with

Claude Desktop

Example client config

{\n  "mcpServers": {\n    "hackmd": {\n      "command": "npx",\n      "args": ["-y", "hackmd-mcp"],\n      "env": {\n        "HACKMD_API_TOKEN": "your_api_token"\n      }\n    }\n  }\n}

Notes

A Model Context Protocol server that connects HackMD’s collaborative note-taking platform to AI assistants. It enables reading, creating, and managing HackMD notes through the MCP interface.

60 stars on GitHub. Last updated 2025-11-28. Licensed MIT.

Use cases

• Automating note creation and organization in HackMD from an AI assistant
• Retrieving and summarizing existing HackMD notes during a conversation
• Integrating HackMD as a knowledge base for AI-driven workflows

Pros

• Straightforward MCP implementation for HackMD integration
• Written in TypeScript with clear code structure
• Low barrier to entry for developers already using MCP

Cons

• Limited to HackMD’s API capabilities and rate limits
• Small community with only 60 stars, less battle-tested
• Requires manual setup of API tokens and MCP configuration

Indexed from awesome-mcp-servers-punkpeye and enriched against its public facts.