Best for
- Developers who want to integrate HackMD note management into AI workflows
- Individuals or teams who prefer natural language interaction with their notes
- Users who need cloud deployment of MCP servers
H
HackMD MCP Server
Community
A Model Context Protocol server for integrating HackMD's note-taking platform with AI assistants.
GitHub source repository ↗
58FMRS · C
This server is focused on HackMD note management, implementing CRUD operations on notes, teams, history, and user profile. Installation is straightforward, and it supports multiple transports, making it suitable for integration into MCP-capable AI clients. Security relies on user's care in protecting the API token.
This is 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. It supports both STDIO and HTTP transports, and is cloud-deployment ready via platforms like Smithery.
Tools
get_user_info
Get information about the authenticated user
list_teams
List all teams accessible to the user
get_history
Get user's reading history
list_team_notes
List all notes in a team
create_team_note
Create a new note in a team
update_team_note
Update an existing note in a team
delete_team_note
Delete a note in a team
list_user_notes
List all notes owned by the user
get_note
Get a note by its ID
create_note
Create a new note
update_note
Update an existing note
delete_note
Delete a note
Setup
- Ensure Node.js 18+ is installed.
- Add the configuration above to your MCP client config file (e.g., mcp.json or claude_desktop_config.json).
- Restart your MCP client.
- Use the tools to interact with HackMD.
claude_desktop_config.json
{
"mcpServers": {
"hackmd": {
"command": "npx",
"args": ["-y", "hackmd-mcp"],
"env": {
"HACKMD_API_TOKEN": "your_api_token"
}
}
}
}
Fit and risk
Not for
- Not suitable for users without a HackMD API token
- Not suitable for offline access to notes (server depends on network API)
- Not for scenarios requiring advanced collaboration features like real-time co-editing, as the server provides mainly CRUD operations
Required permissions
- Requires HackMD API token (HACKMD_API_TOKEN) to authenticate all operations
- Server can read and modify user profile, notes, teams, history, etc., depending on token permissions
Risks and side effects
- API token leakage could lead to unauthorized account access; never commit it to version control
- For HTTP transport, if the server is hosted without endpoint protection, anyone could use your token
- Server modifies user data (create, update, delete notes); confirm before operations
Troubleshooting
- Check that HACKMD_API_TOKEN is set correctly and not expired
- Verify network connectivity to HackMD API
- Inspect MCP client logs for error details
- For HTTP transport, ensure ALLOWED_HACKMD_API_URLS is configured correctly, otherwise requests may be rejected
Use cases
Quickly create and manage HackMD notes via an AI assistant
Ask AI to list and organize user notes and team notes
Automate note updates and archiving in team collaboration
Supported clients
Claude DesktopFull support