Contentful MCP Server

An MCP server implementation that integrates with Contentful's Content Management API, providing comprehensive content management capabilities.

• Please note *; if you are not interested in the code, and just want to use this MCP in Claude Desktop (or any other tool that is able to use MCP servers) you don't have to clone this repo, you can just set it up in Claude desktop, refer to the section "Usage with Claude Desktop" for instructions on how to install it.

Features

• Content Management: Full CRUD operations for entries and assets
• Space Management: Create, update, and manage spaces and environments
• Content Types: Manage content type definitions
• Localization: Support for multiple locales
• Publishing: Control content publishing workflow

Tools

Entry Management

• search_entries: Search for entries using query parameters
• create_entry: Create new entries
• get_entry: Retrieve existing entries
• update_entry: Update entry fields
• delete_entry: Remove entries
• publish_entry: Publish entries
• unpublish_entry: Unpublish entries

Asset Management

• upload_asset: Upload new assets with metadata
• get_asset: Retrieve asset details and information
• update_asset: Update asset metadata and files
• delete_asset: Remove assets from space
• publish_asset: Publish assets to delivery API
• unpublish_asset: Unpublish assets from delivery API

Space & Environment Management

• list_spaces: List available spaces
• get_space: Get space details
• list_environments: List environments in a space
• create_environment: Create new environment
• delete_environment: Remove environment

Content Type Management

• list_content_types: List available content types
• get_content_type: Get content type details
• create_content_type: Create new content type
• update_content_type: Update content type
• delete_content_type: Remove content type

Development Tools

MCP Inspector

The project includes an MCP Inspector tool that helps with development and debugging:

• Inspect Mode: Run npm run inspect to start the inspector
• Watch Mode: Use npm run inspect:watch to automatically restart the inspector when files change
• Visual Interface: The inspector provides a web interface to test and debug MCP tools
• Real-time Testing: Try out tools and see their responses immediately

Configuration

Prerequisites

1. Create a Contentful account at Contentful
2. Generate a Content Management API token from your account settings

Environment Variables

• CONTENTFUL_MANAGEMENT_ACCESS_TOKEN: Your Content Management API token

Usage with Claude Desktop

You do not need to clone this repo to use this MCP, you can simply add it to your claude_desktop_config.json:

Add or edit ~/Library/Application Support/Claude/claude_desktop_config.json and add the following lines:

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

Error Handling

The server implements comprehensive error handling for:

• Authentication failures
• Rate limiting
• Invalid requests
• Network issues
• API-specific errors

License

MIT License