yuna0x0-hackmd-mcp — Claude Code MCP server: setup guide
Connects HackMD workspaces and notes to your coding assistant. Helps you fetch, write, and edit shared documents directly in chat.
claude mcp add --transport http yuna0x0-hackmd-mcp https://server.smithery.ai/@yuna0x0/hackmd-mcp/mcpWhat yuna0x0-hackmd-mcp does
This server connects coding assistants to the HackMD API. It provides tools for reading markdown notes by identifier, updating draft text, and listing personal files. It supports history lookups.
The toolset covers shared team spaces as well. You can inspect member groups, fetch group notes, and create team drafts during coding sessions. It supports STDIO launches via npx or standalone HTTP serving on port 8081. Running it requires Node.js 18. Without a valid HACKMD_API_TOKEN, every tool call fails immediately.
What it helps with
- retrieve notes and drafts by identifier
- publish team notes directly from chat
- inspect recent account reading history
- update markdown documents without opening a browser
Example prompts for the agent
- Show my personal notes from HackMD
- Create a team note about the sprint and add discussion points
- Fetch the contents of note
note_id
How to install yuna0x0-hackmd-mcp
Platform CLI: remote server
claude mcp add --transport http yuna0x0-hackmd-mcp https://server.smithery.ai/@yuna0x0/hackmd-mcp/mcpPlatform CLI: remote server
codex mcp add yuna0x0-hackmd-mcp --url https://server.smithery.ai/@yuna0x0/hackmd-mcp/mcpConfig file
{
"mcpServers": {
"yuna0x0-hackmd-mcp": {
"url": "https://server.smithery.ai/@yuna0x0/hackmd-mcp/mcp"
}
}
}Config file
{
"servers": {
"yuna0x0-hackmd-mcp": {
"type": "http",
"url": "https://server.smithery.ai/@yuna0x0/hackmd-mcp/mcp"
}
}
}Platform CLI: remote server
gemini mcp add -t http yuna0x0-hackmd-mcp https://server.smithery.ai/@yuna0x0/hackmd-mcp/mcpStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about yuna0x0-hackmd-mcp
How to install yuna0x0-hackmd-mcp in Claude Code?
Run claude mcp add --transport http yuna0x0-hackmd-mcp https://server.smithery.ai/@yuna0x0/hackmd-mcp/mcp in your terminal.
What does yuna0x0-hackmd-mcp do?
It gives your LLM client tools to fetch, edit, and organize HackMD documents. You can also view reading logs and manage shared team workspaces.
What credentials does it require?
You need a personal HACKMD_API_TOKEN generated in your HackMD settings and Node.js 18 or newer.
