How do I get a HackMD API token?
Go to [HackMD settings](https://hackmd.io/settings#api), click “Create API Token”, then copy the generated token. Use it in the `HACKMD_API_TOKEN` environment variable or in an HTTP header.
HackMD MCP Server
@yuna0x0
Basic information
About HackMD MCP Server
A Model Context Protocol server for integrating HackMD's note-taking platform with AI assistants.
HackMD MCP Server config
Add this server to your MCP-compatible client using the configuration below.
{
"mcpServers": {
"hackmd": {
"command": "npx",
"args": [
"-y",
"hackmd-mcp"
],
"env": {
"HACKMD_API_TOKEN": "your_api_token"
}
}
}
}HackMD MCP Server tools
Tool list not available yet
This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.
Fetch the live tool list by running this server in a temporary sandbox using the button above.
Overview
What is 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 reading history.
How to use HackMD MCP Server?
Install the server by adding it to your MCP client configuration (e.g., mcp.json or claude_desktop_config.json) with the command npx -y hackmd-mcp and setting the environment variable HACKMD_API_TOKEN. You may optionally set HACKMD_API_URL for a different API endpoint. For self‑hosted HTTP transport, run pnpm run start:http (default port 8081, configurable via PORT). Cloud deployment is supported via platforms like Smithery.
Key features of HackMD MCP Server
- Retrieve authenticated user profile information
- Create, read, update, and delete HackMD notes
- Manage team notes and collaborate with team members
- Access user reading history and list teams
- Dual transport support: HTTP and STDIO
- Cloud‑deployment ready (Smithery and others)
Use cases of HackMD MCP Server
- Manage and organize personal HackMD notes via an AI assistant
- Collaborate on team notes and list team‑accessible notes
- Automate note creation from meeting summaries or daily logs
- Query reading history to quickly revisit recently viewed notes
Frequently asked questions
What environment variables are required?
`HACKMD_API_TOKEN` is required for all operations. `HACKMD_API_URL` is optional (defaults to `https://api.hackmd.io/v1`). For HTTP transport servers, you may also set `ALLOWED_HACKMD_API_URLS` to restrict allowed API URLs.
What transports does the server support?
The server supports both STDIO transport (for local MCP clients) and HTTP transport (for self‑hosted or cloud deployments). The HTTP server listens on port 8081 by default.
What are the system requirements?
Node.js 18 or later is required. The server can also be run via Docker from `ghcr.io/yuna0x0/hackmd-mcp`.
How is the API token kept secure?
The token is accepted via environment variable, `.env` file, or HTTP header. The README warns not to commit it to version control and to protect the HTTP endpoint with authentication if hosting it publicly.
More Other MCP servers
MaxKB
1Panel-dev🔥 MaxKB is an open-source platform for building enterprise-grade agents. 强大易用的开源企业级智能体平台。
22.0K
🚀 Model Context Protocol (MCP) Curriculum for Beginners
microsoftThis open-source curriculum introduces the fundamentals of Model Context Protocol (MCP) through real-world, cross-language examples in .NET, Java, TypeScript, JavaScript, Rust and Python. Designed for developers, it focuses on practical techniques for building modular, scalable,
16.7K
MCP Toolbox for Databases
googleapisMCP Toolbox for Databases is an open source MCP server for databases.
15.9K
Blender
ahujasidOpen-source MCP to use Blender with any LLM
23.6K
N
Next Generation Movers: free moving quotes (remote MCP)
Next Generation MoversFree moving quotes for AI agents from Next Generation Movers, a licensed interstate mover (USDOT 3764697). US long-distance nationwide and local DC/MD/VA. Indicative ballpark price and booking options; optional $0.01 x40
Comments