hackmd-mcpA Model Context Protocol server for integrating HackMD's note-taking platform with AI assistants.

— (0)

Reviewed by Daniel Nikulshyn·Updated July 2026

Overview

HackMD MCP Server is a Model Context Protocol (MCP) server that interfaces with the HackMD API. It allows LLM clients to access and interact with HackMD notes, teams, user profiles, and history data. The server features include getting user profile information, creating, reading, updating, and deleting notes, managing team notes and collaborating with team members, accessing reading history, listing and managing teams. It supports dual transport modes - HTTP and STDIO - and is cloud deployment ready. To use the HackMD MCP Server, you need to set up a HackMD API token and install the server by adding it to your mcp.json or claude_desktop_config.json file. You can then use the tools to interact with the HackMD server. The server can be deployed locally or in the cloud, and configuration can be done either via environment variables or HTTP headers.

Key features

Get user profile information
Create, read, update, and delete notes
Manage team notes and collaborate with team members
Access reading history
List and manage teams
Dual transport support: HTTP and STDIO

Pricing

Model: Free
Category: MCP Servers
Rating: No reviews yet

Use cases

AI-Powered Note Management

Use the HackMD MCP Server to integrate HackMD with AI assistants, enabling features like automated note organization and content generation.

Team Collaboration

Deploy the HackMD MCP Server to facilitate team collaboration, allowing team members to access and manage shared notes through AI interfaces.

Pros & Cons

Pros

Integrates HackMD with AI assistants through Model Context Protocol
Supports both HTTP and STDIO transports for flexibility
Ready for cloud deployment on platforms like Smithery
Allows for user profile information access and team note management

Cons

Requires HackMD API token for operation
Self-hosting requires Node.js 18+ and local development setup
Security considerations for protecting the endpoint when pre-configuring the token

Reviews

No reviews yet. Be the first!

Q&A

Are there any security concerns with using the API token?

Yes, you must protect the endpoint and the API token when pre‑configuring it, as it grants access to all your HackMD data.

Asked by Sami Virtanen · Nov 9, 2025

What functionality does the MCP server provide for notes and teams?

It allows you to get user profiles, create/read/update/delete notes, manage team notes and collaboration, access reading history, and list/manage teams via the HackMD API.

Asked by Tomáš Novák · Oct 8, 2025

Can I run the server both locally and in the cloud?

Yes, the server is cloud‑deployment ready and can also be run locally. It supports HTTP and STDIO transport modes for flexible integration.

Asked by Ravi Chandrasekaran · Aug 31, 2025

What do I need to set up HackMD MCP Server?

You need a HackMD API token and a Node.js 18+ environment if self‑hosting. Add the token to mcp.json or claude_desktop_config.json, then install the server.

Asked by Emeka Obi · Aug 27, 2025