An MCP server that integrates with Contentful's Content Management API, providing comprehensive content management capabilities, including CRUD operations for entries, assets, comments, spaces, and content types.

Installation

NPX

npx -y @ivotoby/contentful-management-mcp-server

Smithery

npx -y @smithery/cli install @ivotoby/contentful-management-mcp-server --client claude

Configuration

Claude Desktop (Environment Variables)

{
  "mcpServers": {
    "contentful": {
      "command": "npx",
      "args": ["-y", "@ivotoby/contentful-management-mcp-server"],
      "env": {
        "CONTENTFUL_MANAGEMENT_ACCESS_TOKEN": "<Your CMA token>"
      }
    }
  }
}

Claude Desktop (Arguments)

{
  "mcpServers": {
    "contentful": {
      "command": "npx",
      "args": [
        "-y",
        "@ivotoby/contentful-management-mcp-server",
        "--management-token",
        "<your token>",
        "--host",
        "http://api.contentful.com"
      ]
    }
  }
}

Available Tools

Tool	Description
search_entries	Search entries using query parameters
create_entry	Create new entries
get_entry	Retrieve existing entries
update_entry	Update entry fields
delete_entry	Delete entries
publish_entry	Publish entries
unpublish_entry	Unpublish entries
get_comments	Retrieve comments for an entry with status filtering
create_comment	Create new comments on entries with support for nested discussions
get_single_comment	Retrieve a specific comment by its ID for an entry
delete_comment	Delete a specific comment from an entry
update_comment	Update existing comments with new content or status changes
bulk_publish	Publish multiple entries and assets in a single operation
bulk_unpublish	Unpublish multiple entries and assets in a single operation
bulk_validate	Validate multiple entries for content consistency, links, and required fields

Features

• Full CRUD operations for entries and assets
• Comment management with support for nested discussions
• Space and environment management
• Content type definition management
• Localization support for multiple locales
• Content publication workflow control
• Bulk operations for publishing, unpublishing, and validation
• Smart pagination (3 items per request to prevent context overflow)
• Support for both stdio and StreamableHTTP transport modes
• App Identity authentication support

Environment Variables

Required

• CONTENTFUL_MANAGEMENT_ACCESS_TOKEN - Your Content Management API token

Optional

• CONTENTFUL_HOST - Contentful Management API endpoint (default: https://api.contentful.com)
• ENABLE_HTTP_SERVER - Set to 'true' to enable HTTP/SSE mode
• HTTP_PORT - Port for HTTP server (default: 3000)
• HTTP_HOST - Host for HTTP server (default: localhost)
• SPACE_ID - Restrict operations to a specific space ID
• ENVIRONMENT_ID - Restrict operations to a specific environment ID

Notes

This is a community server alongside Contentful's official server, also available separately. Supports both Management API tokens and App Identity authentication. Includes MCP Inspector for development and debugging. Warning: This server provides full content management capabilities, including deletion, so use with caution. Not officially supported by Contentful.