HackMD

HackMD

An MCP server enabling LLMs to access HackMD notes, teams, and profiles.

44
Stars
7
Forks
20
Releases

Overview

An MCP server that interfaces with the HackMD API to expose notes, teams, user profiles, and reading history to LLM clients. It supports CRUD operations on individual and team notes, allows listing and managing teams, and retrieving user profile and reading history data. The server provides dual transport options: HTTP transport for cloud deployment and STDIO transport for local client integration. It is designed to be cloud-deployment ready (e.g., Smithery) and runs on Node.js 18+. Configuration is via environment variables (HACKMD_API_TOKEN and HACKMD_API_URL) or HTTP headers when using HTTP transport. Security considerations include protecting tokens and an optional ALLOWED_HACKMD_API_URLS list to restrict endpoints. The project includes tools such as get_user_info, list_teams, get_history, list_team_notes, create_team_note, update_team_note, delete_team_note, list_user_notes, get_note, create_note, update_note, and delete_note. It also provides debugging with the MCP Inspector, Docker images, local development instructions, and MCP Bundle packaging. This server is intended for developers building AI-assisted workflows that rely on HackMD data and collaboration features via MCP.

Details

Owner
yuna0x0
Language
TypeScript
License
MIT License
Updated
2025-12-07

Features

Get user profile information

Fetch authenticated user's HackMD profile details from the HackMD API via MCP.

Create, read, update, and delete notes

CRUD operations on notes, including user-owned and team notes.

Manage team notes and collaboration

Operate notes within teams and support collaboration with team members.

Access reading history

Retrieve the user's HackMD reading/history data.

List and manage teams

List teams accessible to the user and perform basic team management.

Dual transport support

Supports both HTTP and STDIO transports for MCP clients.

Cloud deployment ready

Designed for cloud deployment on Smithery and compatible platforms.

Audience

LLMsEnable LLMs to access HackMD notes, teams, profiles, and history data through MCP.
DevelopersIntegrate HackMD MCP server into AI-assisted workflows to manage notes.

Tags

HackMDMCPnotesteamsprofileshistoryHTTP transportSTDIO transportCloud deploymentSmitheryNode.jsAPI tokenauthenticationenvironment variablesHTTP headersMCP InspectorDockerMCP Bundles