HackMD

@hackmd list all my notes and show me which ones were updated in the last week

Found 47 notes in your personal workspace. 6 were modified in the past 7 days: • "Q1 Planning Draft" (updated 2 days ago) • "API Integration Spec" (updated 3 days ago) • "Team Retro Notes - Jan 15" (updated 4 days ago) • "Database Migration Checklist" (updated 5 days ago) • "Customer Feedback Summary" (updated 6 days ago) • "Sprint Goals - Week 3" (updated 6 days ago) This example illustrates the typical response when combining the List Notes tool with date filtering logic. Your actual note titles and timestamps will differ.

This showcases read-only workspace visibility. The MCP retrieves all personal notes in a single call (no pagination), so large workspaces return immediately. Team notes require the team_path parameter and were not live-tested; personal workspace access is guaranteed with any valid API key.

@hackmd create a new note titled "Weekly Standup Template" with sections for Wins, Blockers, and Next Steps

Created note "Weekly Standup Template" in your personal workspace. The note includes three Markdown sections: ## Wins ## Blockers ## Next Steps Note ID: abc123xyz. You can edit it at https://hackmd.io/@youruser/abc123xyz or retrieve the full content with Get Note. This example demonstrates a typical creation response; the actual ID and URL will reflect your account.

This highlights the Create Note tool's ability to scaffold structured documents. You can optionally place the note in a folder by passing parent_folder_id (use List Folders to find IDs). Team workspace creation requires team_path and appropriate permissions; the personal workspace is always writable.

@hackmd get the content of my "API Integration Spec" note and summarize the authentication requirements

Retrieved "API Integration Spec" (note ID: def456ghi). The authentication section specifies: • OAuth 2.0 with PKCE flow for web clients • API key authentication for server-to-server calls • JWT tokens expire after 1 hour; refresh tokens valid for 30 days • Rate limit: 100 requests per minute per key This example shows how the Get Note tool returns full Markdown content, which the AI can then parse and synthesize. Your note's actual authentication details will vary.

This pairs the Get Note tool with AI reasoning to extract specific information from long documents. The MCP fetches the raw Markdown; the AI handles interpretation. Note IDs are stable, so you can reference the same note across multiple prompts. Trash recovery is supported for personal notes via Restore Notes.

When HackMD beats Google Docs for standup capture

A 6-person startup runs daily standups and wants AI to pull action items from the notes. HackMD wins here because the Create Note and Get Note tools let Switchy write meeting summaries directly into the team's shared workspace, then read them back to extract tasks or blockers. The Markdown format means no formatting drift, and the 8-tool scope keeps the AI focused on note CRUD without wandering into comment threads or version history. The trade-off: HackMD has no inline task management, so if your team needs to assign owners or due dates inside the doc, you'll still export to Linear or Asana. If your workflow is capture-then-triage, HackMD is the right call.

Why HackMD works for support teams under 15 agents

A 12-agent support team maintains troubleshooting guides in HackMD and wants AI to update them after each escalation. The List Notes and Get Note tools let Switchy scan the knowledge base for outdated steps, then Create Note or update existing docs with new workarounds. The API_KEY auth means every agent can grant Switchy access without IT provisioning, and the folder structure (via List Folders) keeps product-line guides organized. The boundary: HackMD has no search ranking or analytics, so if your KB has 200+ articles and you need to surface the most-viewed docs, Notion or Confluence will serve you better. For teams that treat docs as living Markdown files and want fast AI edits, HackMD delivers.

HackMD for multi-team retro rollup at mid-size scale

Three product squads (18 people total) write retros in separate HackMD team workspaces, and the PM wants AI to synthesize themes across all three. The Get Account tool reveals which teams the token can see, then List Notes pulls retros from each team_path, and Get Note fetches the Markdown for analysis. The 8-tool kit is lean enough that Switchy won't try to edit permissions or manage trash, keeping the scope on read-then-summarize. The catch: the team routes weren't live-tested in this integration, so if your squads use team workspaces heavily, verify the team_path parameter works in your environment before committing. For orgs where retros live in personal or lightly-shared spaces, this is a clean fit.