# yuna0x0-hackmd-mcp

Connects HackMD workspaces and notes to your coding assistant. Helps you fetch, write, and edit shared documents directly in chat.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 67
- Author: yuna0x0
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/yuna0x0/hackmd-mcp
- Updated: 2026-07-13
- HTML: https://affpapa.org/en/nevibecode/mcp/yuna0x0-hackmd-mcp

## What it 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.

## Requirements
- Remote server: `https://server.smithery.ai/@yuna0x0/hackmd-mcp/mcp`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http yuna0x0-hackmd-mcp https://server.smithery.ai/@yuna0x0/hackmd-mcp/mcp
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add yuna0x0-hackmd-mcp --url https://server.smithery.ai/@yuna0x0/hackmd-mcp/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "yuna0x0-hackmd-mcp": {
            "url": "https://server.smithery.ai/@yuna0x0/hackmd-mcp/mcp"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "yuna0x0-hackmd-mcp": {
            "type": "http",
            "url": "https://server.smithery.ai/@yuna0x0/hackmd-mcp/mcp"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http yuna0x0-hackmd-mcp https://server.smithery.ai/@yuna0x0/hackmd-mcp/mcp
```

## When to use it
- 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
- Show my personal notes from HackMD
- Create a team note about the sprint and add discussion points
- Fetch the contents of note `note_id`

## Similar
- [Reactive Resume](https://affpapa.org/en/nevibecode/mcp/reactive-resume.md) — MCP server · ★ 44874
- [Sui Knowledge Base (kapa.ai)](https://affpapa.org/en/nevibecode/mcp/sui-knowledge-base-kapaai.md) — MCP server · ★ 7784
- [Claude Code Ultimate Guide](https://affpapa.org/en/nevibecode/mcp/claude-code-ultimate-guide.md) — MCP server · ★ 6237
- [Zotero MCP](https://affpapa.org/en/nevibecode/mcp/zotero-mcp.md) — MCP server · ★ 5548
- [RevoGrid DataGrid MCP Pro](https://affpapa.org/en/nevibecode/mcp/revogrid-datagrid-mcp-pro.md) — MCP server · ★ 3450
- [Claude Code Explorer MCP](https://affpapa.org/en/nevibecode/mcp/codeaashu-claude-code-explorer-mcp.md) — MCP server · ★ 3409

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md