Postmd MCP Server
by reinlainerio.github.reinlainer/postmd-mcp-serverv2.6.1
Publish Markdown as a shareable web page, with document graphs
context tax
queued
security
queued
cold start
queued
freshness
Active5d ago
Install Postmd MCP server
Install in Claude Code
claude mcp add postmd -e POSTMD_API_KEY='<postmd-api-key>' -- npx -y postmd-mcp-serverInstall in Cursor
{
"mcpServers": {
"postmd": {
"command": "npx",
"args": [
"-y",
"postmd-mcp-server"
],
"env": {
"POSTMD_API_KEY": "<postmd-api-key>"
}
}
}
}Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).
Install in Claude Desktop
{
"mcpServers": {
"postmd": {
"command": "npx",
"args": [
"-y",
"postmd-mcp-server"
],
"env": {
"POSTMD_API_KEY": "<postmd-api-key>"
}
}
}
}Settings → Developer → Edit Config (claude_desktop_config.json), then restart.
Install in VS Code
{
"servers": {
"postmd": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"postmd-mcp-server"
],
"env": {
"POSTMD_API_KEY": "<postmd-api-key>"
}
}
}
}Add to .vscode/mcp.json in your workspace.
Install in Windsurf
{
"mcpServers": {
"postmd": {
"command": "npx",
"args": [
"-y",
"postmd-mcp-server"
],
"env": {
"POSTMD_API_KEY": "<postmd-api-key>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json.
Configuration
| Variable | Required | Secret | Description |
|---|---|---|---|
| POSTMD_BASE_URL | — | — | Where PostMD runs. Defaults to https://postmd.turink.com; set it only for a self-hosted instance. |
| POSTMD_API_KEY | — | yes | Needed only for managing documents and groups. Publishing and reading work without it. |
| POSTMD_DEBUG | — | — | Set to 1 for verbose diagnostics on stderr. |
Remote endpoints
- streamable-http
https://postmd.turink.com/mcp
Freshness
Active — last maintenance signal 5d ago. The newest of the signals below sets the band.
Last commit (default branch)
2026-10-04 · 5d ago · GitHub
Latest release
no data · GitHub
Package published
no data · npm/PyPI
Registry entry updated
2026-10-04 · 5d ago · official registry · v2.6.1
FAQ
›How do I install the Postmd MCP server in Claude Code?
Run: claude mcp add postmd -e POSTMD_API_KEY='<postmd-api-key>' -- npx -y postmd-mcp-server. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.
›Does Postmd require an API key?
Yes. It expects POSTMD_API_KEY, of which 1 is a secret.
›Can I use Postmd as a remote (hosted) MCP server?
Yes — it offers both a hosted endpoint and a local stdio package.
›Is Postmd in the official MCP registry?
Yes, as io.github.reinlainer/postmd-mcp-server.