yuna0x0 avatar

Yuna0x0 Hackmd Mcp

yuna0x0/hackmd-mcp

Wraps the HackMD API to let you manage notes, teams, and reading history without leaving your LLM client. You get full CRUD operations on both personal and team notes, plus profile lookups and team listings. Supports dual transports: stdio for local Claude Desktop use or HTTP for cloud deployment. Useful when you're already documenting in HackMD and want to query, create, or update notes conversationally instead of switching to the web interface. Authentication requires a HackMD API token, which you can pass via environment variable or HTTP header depending on your transport choice.

GitHub stars
61
tools
12
auth
Required
transport
HTTP
last updated
Sep 29, 2025

Tools

12 tools

Public tool metadata for what this MCP can expose to an agent.

get_user_infoGet information about the authenticated user

Get information about the authenticated user

No parameter schema in public metadata yet.

list_teamsList all teams accessible to the user

List all teams accessible to the user

No parameter schema in public metadata yet.

get_historyGet user's reading history

Get user's reading history

No parameter schema in public metadata yet.

list_team_notesList all notes in a team

List all notes in a team

No parameter schema in public metadata yet.

create_team_noteCreate a new note in a team

Create a new note in a team

No parameter schema in public metadata yet.

update_team_noteUpdate an existing note in a team

Update an existing note in a team

No parameter schema in public metadata yet.

delete_team_noteDelete a note in a team

Delete a note in a team

No parameter schema in public metadata yet.

list_user_notesList all notes owned by the user

List all notes owned by the user

No parameter schema in public metadata yet.

get_noteGet a note by its ID

Get a note by its ID

No parameter schema in public metadata yet.

create_noteCreate a new note

Create a new note

No parameter schema in public metadata yet.

update_noteUpdate an existing note

Update an existing note

No parameter schema in public metadata yet.

delete_noteDelete a note

Delete a note

No parameter schema in public metadata yet.

Sponsors

Readme

HackMD MCP Server

A Model Context Protocol (MCP) server that interfaces with the HackMD API, allowing LLM clients to access and interact with HackMD notes, teams, user profiles, and history data.

Features

  • Get user profile information
  • Create, read, update, and delete notes
  • Manage team notes and collaborate with team members
  • Access reading history
  • List and manage teams
  • Dual transport support: Both HTTP and STDIO transports
  • Cloud deployment ready: Support Smithery and other platforms

Requirements

  • Node.js 18+

Local Installation (STDIO Transport)

  1. Add this server to your mcp.json / claude_desktop_config.json:
{
  "mcpServers": {
    "hackmd": {
      "command": "npx",
      "args": ["-y", "hackmd-mcp"],
      "env": {
        "HACKMD_API_TOKEN": "your_api_token"
      }
    }
  }
}

You may also optionally set the HACKMD_API_URL environment variable if you need to use a different HackMD API endpoint.

  1. Restart your MCP client (e.g., Claude Desktop)
  2. Use the tools to interact with HackMD

Server Deployment (HTTP Transport)


View the full README on GitHub

Details

Repository
github.com/yuna0x0/hackmd-mcp
Category
Communication & Messaging
Transport
HTTP
Auth
Required
Registry
MCP registry, active

More from yuna0x0

Related Communication & Messaging MCP servers

View all
1esaio avataresaesaio/esa-mcp-serverOfficial MCP server for esa.io - a documentation sharing service for teams61stars
2stabgan avatarOpenrouter Multimodalstabgan/openrouter-mcp-multimodalChat with 300+ LLMs via OpenRouter. Analyze and generate images, audio, and video from MCP.45stars
3btouchard avatarHeraldbtouchard/heraldStop copy-pasting between Claude Chat and Claude Code.43stars
4upinar avatarContrastAPIupinar/contrastapi55 tools, 7 Resources, Sigma rules, email SPF/DMARC, MITRE, CVE/KEV, risk_score. No key.36stars
5w1ne avatarkernelCADw1ne/kernelcad-webCAD in ChatGPT and Claude: editable parts, STEP/STL/drawings, in-chat 3D, automatic checks.0stars
6houtini-ai avatarGeminihoutini-ai/gemini-mcpModel Context Protocol server for Google Gemini AI with chat, research, and grounding34stars