mcp-craft-add-blog

An MCP server that publishes local markdown files as blog posts to Craft.do.

Give it a .md file path — it parses the first # Heading as the post title, splits the body into properly sized blocks (respecting Craft's limits), and creates a subpage with all content blocks back-to-back.

Install

npx -y mcp-craft-add-blog@latest

Setup

1. Get Your Craft API Credentials

1. Open Craft → Settings → API
2. Click Create Connection, choose the target document
3. Copy the endpoint URL: https://connect.craft.do/links/<your-key-id>/api/v1
4. Note the page ID (UUID) where blog posts should be created

2. Configure Your MCP Client

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "craft-blog": {
      "command": "npx",
      "args": ["-y", "mcp-craft-add-blog@latest"],
      "env": {
        "CRAFT_API_URL": "https://connect.craft.do/links/<your-key-id>/api/v1",
        "CRAFT_PAGE_ID": "<your-page-uuid>"
      }
    }
  }
}

Claude Code

claude mcp add craft-blog \
  -e CRAFT_API_URL="https://connect.craft.do/links/<your-key-id>/api/v1" \
  -e CRAFT_PAGE_ID="<your-page-uuid>" \
  -- npx -y mcp-craft-add-blog@latest

Environment Variables

| Variable | Required | Description | |----------|----------|-------------| | CRAFT_API_URL | Yes | Craft API base URL (auth is embedded in the URL — no headers needed) | | CRAFT_PAGE_ID | Yes | Default parent page ID where blog posts are created as subpages |

Tool

publish_blog_post

| Parameter | Required | Description | |-----------|----------|-------------| | filePath | Yes | Absolute path to the .md file | | pageId | No | Override parent page (defaults to CRAFT_PAGE_ID) |

What it does:

1. Reads the markdown file from disk
2. Extracts the first # Heading as the blog post title
3. Splits the remaining body into chunks (≤ 8,000 chars each) at heading and paragraph boundaries — small fragments are merged to avoid tiny trailing blocks
4. Creates a Craft subpage (card style) with all content blocks in order

Example prompt:

"Publish the blog post at /Users/me/posts/my-article.md to Craft"

Development

git clone https://github.com/yigitkonur/mcp-craft-add-blog.git
cd mcp-craft-add-blog
npm install
npm run build

CRAFT_API_URL="..." CRAFT_PAGE_ID="..." node dist/index.js

License

MIT