A Model Context Protocol server for integrating HackMD's note-taking platform with AI assistants.
Hackmd mcp server connects HackMD to AI assistants that speak the Model Context Protocol. A Model Context Protocol server for integrating HackMD's note-taking platform with AI assistants.
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.
Once connected, the assistant can call these 13 tools directly:
get_user_info — Get information about the authenticated userlist_teams — List all teams accessible to the userget_history — Get user's reading historylist_team_notes — List all notes in a teamcreate_team_note — Create a new note in a teamupdate_team_note — Update an existing note in a teamdelete_team_note — Delete a note in a teamlist_user_notes — List all notes owned by the userget_note — Get a note by its IDcreate_note — Create a new noteupdate_note — Update an existing notedelete_note — Delete a noteConfiguration — 1. Create a .env file by copying the example: bash cp env.example .envThe server is distributed via npm as @modelcontextprotocol/inspector, so most clients can run it without a manual build step. Add it to your MCP client's configuration and restart the client to pick it up — the copy-paste configs for Claude Desktop, Claude Code and Cursor are on this page.
Before the server will start you need to supply 2 environment variables: HACKMD_API_TOKEN, HACKMD_API_URL. Keep credentials in your client's env block or a secrets manager rather than committing them.
Productivity servers pay off through capture: the tasks and notes that never get filed are the ones where opening the app is more friction than the thought is worth. HackMD sits in that group, and the shape of its toolset — get_user_info, list_teams, get_history among others — tells you what it is really for. Worth comparing against the other productivity servers in this directory before you commit to one, since several overlap in scope but differ sharply in setup cost and permissions.
| Tool | What it does |
|---|---|
| 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 |
| Configuration | 1. Create a .env file by copying the example: bash cp env.example .env |
{
"mcpServers": {
"hackmd": {
"command": "npx",
"args": ["-y", "hackmd-mcp"],
"env": {
"HACKMD_API_TOKEN": "your_api_token"
}
}
}
}Configuration as documented by the project. Restart the client after saving.
| Variable | Description | Required |
|---|---|---|
| HACKMD_API_TOKEN | Credential the server authenticates with. | Yes |
| HACKMD_API_URL | Endpoint or connection string the server talks to. | Yes |
Your workspace, on speaking terms with AI — search, read and write Notion pages and databases.
Issue tracking at the speed of conversation — Linear's official hosted server with OAuth and zero install.
Search and read your Drive — Docs, Sheets and files become context your assistant can actually use.
Your assistant inside the workspace — read channels, search history, post messages and tame the noise.
Metabase ships its own MCP endpoint — search your BI content, build and run queries, and save questions and dashboards without leaving the chat.
Stop letting your assistant hallucinate n8n node parameters — this server hands it the real schemas, templates and validation.