
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 toolsPublic 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)
- 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.
- Restart your MCP client (e.g., Claude Desktop)
- Use the tools to interact with HackMD
Server Deployment (HTTP Transport)
Details
- Repository
- github.com/yuna0x0/hackmd-mcp
- Category
- Communication & Messaging
- Transport
- HTTP
- Auth
- Required
- Registry
- MCP registry, active