Back to Home
yuna0x0 icon

hackmd-mcp

Verified Safe

by yuna0x0

Overview

The server provides an interface for LLM clients to access and manage HackMD notes, teams, user profiles, and reading history through the HackMD API.

Installation

Run Command
npx -y hackmd-mcp

Environment Variables

  • HACKMD_API_TOKEN
  • HACKMD_API_URL
  • PORT
  • TRANSPORT
  • CORS_ORIGIN
  • ALLOWED_HACKMD_API_URLS

Security Notes

The server handles sensitive HackMD API tokens via environment variables or HTTP headers. It includes a feature to restrict allowed HackMD API URLs, which is a good security practice. However, if self-hosting the HTTP transport with a pre-configured token, the README explicitly warns that the endpoint must be protected with authentication, otherwise anyone can access the server using the configured token. There is also a point where base64-encoded config from query parameters is JSON parsed, which, while mitigated by subsequent schema validation, could potentially be a vector for malformed data attacks if not robustly handled by the underlying MCP SDK.

Similar Servers

Stats

Interest Score45
Security Score7
Cost ClassMedium
Avg Tokens1000
Stars44
Forks7
Last Update2025-11-28

Tags

HackMDNotesCollaborationAPI WrapperLLM Tools