Halo MCP Server

MCP (Model Context Protocol) server for Halo CMS API. Enables AI assistants like Claude to manage Halo blog systems.

Features

• Post Management: List, create, update, publish, unpublish posts
• Category Management: List, create, update, delete categories
• Tag Management: List, create, update, delete tags
• Comment Management: List comments, create comments and replies
• Attachment Management: List attachments, upload from URL
• Single Page Management: List, create, update, publish pages
• Search: Full-text search across posts
• Stats: Get site statistics
• Menu Access: List menus and menu items
• Plugin & User Info: List plugins and users

Installation

npm install
npm run build

Configuration

Set the following environment variables:

# Required: Your Halo site URL
HALO_BASE_URL=https://your-halo-site.com

# Authentication (choose one):
# Option 1: API Token (recommended)
HALO_API_TOKEN=your-api-token

# Option 2: Username and Password
HALO_USERNAME=your-username
HALO_PASSWORD=your-password

Getting an API Token

1. Log in to your Halo admin console
2. Go to User Center → Personal Access Tokens
3. Create a new token with appropriate permissions

Usage with Claude Desktop

Add to your Claude Desktop configuration (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "halo": {
      "command": "node",
      "args": ["/path/to/halo-mcp/dist/index.js"],
      "env": {
        "HALO_BASE_URL": "https://your-halo-site.com",
        "HALO_API_TOKEN": "your-api-token"
      }
    }
  }
}

Available Tools

Posts

• halo_list_posts - List posts with filtering and pagination
• halo_get_post - Get a specific post by name
• halo_create_post - Create a new post
• halo_update_post - Update an existing post
• halo_publish_post - Publish a draft post
• halo_unpublish_post - Unpublish a post
• halo_recycle_post - Move a post to recycle bin
• halo_get_post_content - Get post content
• halo_update_post_content - Update post content

Categories

• halo_list_categories - List all categories
• halo_get_category - Get a specific category
• halo_create_category - Create a new category
• halo_update_category - Update an existing category
• halo_delete_category - Delete a category
• halo_list_posts_by_category - List posts in a category

Tags

• halo_list_tags - List all tags
• halo_get_tag - Get a specific tag
• halo_create_tag - Create a new tag
• halo_update_tag - Update an existing tag
• halo_delete_tag - Delete a tag
• halo_list_posts_by_tag - List posts with a tag

Comments

• halo_list_comments - List comments
• halo_create_comment - Create a comment
• halo_create_reply - Reply to a comment

Attachments

• halo_list_attachments - List attachments
• halo_upload_attachment_from_url - Upload attachment from URL
• halo_delete_attachment - Delete an attachment

Single Pages

• halo_list_single_pages - List single pages
• halo_get_single_page - Get a specific page
• halo_create_single_page - Create a new page
• halo_update_single_page - Update an existing page
• halo_publish_single_page - Publish a page
• halo_get_single_page_content - Get page content
• halo_update_single_page_content - Update page content

Other

• halo_search - Search posts and pages
• halo_get_stats - Get site statistics
• halo_list_menus - List menus
• halo_get_primary_menu - Get the primary menu
• halo_list_menu_items - List menu items
• halo_list_plugins - List plugins
• halo_list_users - List users
• halo_rebuild_indices - Rebuild search indices

Development

# Run in development mode
npm run dev

# Build for production
npm run build

# Start production server
npm start

License

MIT