Server data from the Official MCP Registry
Collaborative notes via HackMD: user, team, and personal notes with full CRUD.
About
Collaborative notes via HackMD: user, team, and personal notes with full CRUD.
Security Report
collabnotes is a clean, purpose-aligned HackMD API client: it requires HACKMD_API_TOKEN, sends it only as a Bearer header to the HackMD API, validates tool inputs with zod, and makes no unexpected network, shell, or file calls. The only notable finding is that the HACKMD_API_URL override could redirect the bearer token to an arbitrary host if the environment is attacker-controlled, which is a low-severity concern for a user-configured setting. Supply chain analysis found 3 known vulnerabilities in dependencies (0 critical, 2 high severity). Package verification found 1 issue.
8 files analyzed · 7 issues found
Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.
Permissions Required
This plugin requests these system permissions. Most are normal for its category.
What You'll Need
Set these up before or after installing:
How to Install
Add this to your MCP configuration file:
{
"mcpServers": {
"collabnotes": {
"command": "npx",
"args": [
"-y",
"@reneturcios/collabnotes@0.1.0"
],
"env": {
"HACKMD_API_URL": "your-hackmd-api-url-here",
"HACKMD_API_TOKEN": "your-hackmd-api-token-here"
}
}
}
}Some servers take additional arguments. See the repository for details.
Documentation
View on GitHubFrom the project's GitHub README.
collabnotes
collabnotes works with collaborative notes in HackMD: it reads the authenticated user's profile, teams, and reading history, lists team and personal notes, and creates, updates, and deletes notes in both places. It talks to the public HackMD API v1 on your behalf, using a personal API token you supply.
This package is a clean-room rebuild covering the full documented tool set (12 tools) of the original HackMD MCP server.
How it talks to the service
Every tool needs a HackMD API token:
export HACKMD_API_TOKEN="your token"
# Optional override (default: https://api.hackmd.io/v1)
export HACKMD_API_URL="https://api.hackmd.io/v1"
With no token set, every call fails with an error naming
HACKMD_API_TOKEN, before any request is made.
Requests carry Authorization: Bearer HACKMD_API_TOKEN. Path
segments such as team paths and note IDs are URL-encoded. Responses
are returned as parsed JSON; delete calls and empty-body responses
resolve to {"status": "ok", ...} carrying the IDs involved, and an
upstream HTTP error is reported with its status and body. Note that
the HackMD API's create/update permission fields are not part of this
tool spec: creates send only title and content, and updates send
only content.
Install
npx @reneturcios/collabnotes list_user_notes '{}'
Or run the container image:
docker run -i ghcr.io/cloudcorprecords/collabnotes
The container defaults to the MCP server. Pass CLI arguments to use it as a CLI instead.
CLI
The CLI mirrors the tools: one subcommand per tool, taking its arguments as a single JSON object.
collabnotes get_user_info '{}'
collabnotes list_teams '{}'
collabnotes get_history '{}'
collabnotes list_team_notes '{"teamPath":"my-team"}'
collabnotes create_team_note '{"teamPath":"my-team","title":"Spec","content":"# Spec"}'
collabnotes update_team_note '{"teamPath":"my-team","noteId":"abc","content":"# v2"}'
collabnotes delete_team_note '{"teamPath":"my-team","noteId":"abc"}'
collabnotes list_user_notes '{}'
collabnotes get_note '{"noteId":"abc"}'
collabnotes create_note '{"title":"Note","content":"# Note"}'
collabnotes update_note '{"noteId":"abc","content":"# v2"}'
collabnotes delete_note '{"noteId":"abc"}'
collabnotes --version
Exit codes: 0 on success, 1 on an API or validation error (the
error names the problem), 2 for usage errors.
MCP server
One bin serves both faces. The mcp subcommand starts a stdio MCP
server:
npx -y @reneturcios/collabnotes mcp
MCP client configuration:
{
"mcpServers": {
"collabnotes": {
"command": "npx",
"args": ["-y", "@reneturcios/collabnotes", "mcp"],
"env": { "HACKMD_API_TOKEN": "your token" }
}
}
}
Tools
| Tool | Input | What it does |
|---|---|---|
get_user_info | (none) | Get the authenticated HackMD user's information. (GET /me) |
list_teams | (none) | List the teams the authenticated user belongs to. (GET /teams) |
get_history | (none) | Get the authenticated user's note reading history. (GET /history) |
list_team_notes | teamPath (required) | List the notes belonging to a team. |
create_team_note | teamPath, title, content (all required) | Create a new note in a team. |
update_team_note | teamPath, noteId, content (all required) | Update the content of a team note. |
delete_team_note | teamPath, noteId (required) | Delete a team note. |
list_user_notes | (none) | List the authenticated user's own notes. (GET /notes) |
get_note | noteId (required) | Get a single note by its ID. |
create_note | title, content (required) | Create a new personal note. |
update_note | noteId, content (required) | Update the content of a personal note. |
delete_note | noteId (required) | Delete a personal note. |
Development
npm install
npm run build # tsc -> dist/
npm test # node test runner over test/*.test.ts, fake fetch only, no network
npm run dev # run the CLI from source via tsx
License
MIT — see LICENSE.
Reviews
No reviews yet
Be the first to review this server!
More Developer Tools MCP Servers
Rea
Freeby Morluto · Developer Tools
Reverse engineer anything from your terminal or agent with one CLI and MCP server.
Paperclip
Freeby Paperclipai · Developer Tools
Trending hip-hop artist momentum scores across four cultural dimensions.
Scrapling
Freeby D4Vinci · Developer Tools
Web scraping with stealth HTTP, real browsers, and Cloudflare bypass. CSS selectors supported.
Git
Freeby Modelcontextprotocol · Developer Tools
Read, search, and manipulate Git repositories programmatically
Toleno
Freeby Toleno · Developer Tools
Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.
MCP Marketplace
Freeby mcp-marketplace · Developer Tools
Search and install MCP servers from inside your AI client.
