Happy slice of mcp pizzaMCP.pizza

hackmd-mcp

MCP.Pizza Chef: yuna0x0

HackMD MCP Server is a Model Context Protocol server that connects AI assistants with HackMD's note-taking platform. It enables AI models to access user information, manage notes (create, read, update, delete), view read history, and collaborate on team notes via the HackMD API. Designed for Node.js 18+, it requires an API token for secure access and supports customizable API endpoints. This server facilitates real-time, structured interaction between AI and HackMD, enhancing productivity and collaboration.

Use This MCP server To

Retrieve user profile and note metadata from HackMD Create and update HackMD notes via AI commands Delete obsolete or irrelevant notes automatically List and search user notes for quick access Track read history to summarize recent activity Manage team notes collaboratively through AI Integrate HackMD note data into AI workflows Automate note organization and tagging

README

HackMD MCP Server

smithery badge

This is a Model Context Protocol (MCP) server for interacting with the HackMD API. It allows AI assistants to perform operations such as:

  • Get user information
  • List user's notes
  • Create, read, update, and delete notes
  • View read history
  • Work with team notes

Requirements

  • Node.js 18+

Environment Variables

  • HACKMD_API_TOKEN: [Required] Your HackMD API token
  • HACKMD_API_URL: (Optional) HackMD API Endpoint URL. Default: https://api.hackmd.io/v1

You can get an API token from HackMD settings.

Install to Claude Desktop (or other MCP clients)

Installing via Smithery

To install HackMD MCP Server for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @yuna0x0/hackmd-mcp --client claude

# For other MCP clients, use the following command:
# List available clients
npx -y @smithery/cli list clients
# Install to other clients
npx -y @smithery/cli install @yuna0x0/hackmd-mcp --client <client_name>

Installing via mcp-get

npx @michaellatman/mcp-get@latest install hackmd-mcp

hackmd-mcp FAQ

How do I authenticate the HackMD MCP server?
You must provide a valid HackMD API token via the HACKMD_API_TOKEN environment variable for secure access.
Can I customize the HackMD API endpoint?
Yes, set the HACKMD_API_URL environment variable to your desired API URL; it defaults to https://api.hackmd.io/v1.
What Node.js version is required to run this server?
Node.js 18 or higher is required to ensure compatibility and performance.
How does this server handle team notes?
It supports operations on team notes, allowing AI to read, create, update, and manage collaborative notes.
Is this server compatible with multiple MCP clients?
Yes, it can be installed on various MCP clients like Claude Desktop via Smithery.
Where can I get the HackMD API token?
You can generate an API token from your HackMD account settings under the API section.
Does this server support real-time note updates?
It enables AI to perform CRUD operations on notes, facilitating near real-time updates through the HackMD API.
How do I install the HackMD MCP server?
Installation can be done via Smithery CLI or manually by setting environment variables and running the Node.js server.