← Back to directory
C

Contentful MCP Server

Community
An MCP server for the Contentful Management API, enabling comprehensive content management capabilities.
GitHub source repository ↗
★ 62 Stars Category · Cloud Storage Popular Source revision 3f9069518471
58FMRS · C
Reliability
8/20
Security and permissions
10/20
Maintenance
12/20
Documentation
15/20
Setup experience
13/20

This MCP server is community-driven and feature-rich, covering various aspects of Contentful content management. It supports bulk operations and comment threading, but note the pagination limit and potential data risks. It is a convenient tool for Claude users managing Contentful, but consider checking the official server for more authoritative support.

Read the FMRS scoring method →

This is a community-driven MCP server that integrates with Contentful's Content Management API, providing full content management capabilities including entries, assets, comments, spaces, environments, content types, publishing, bulk operations, localization support, and more. It supports both stdio and StreamableHTTP transport modes and can be used with MCP clients like Claude Desktop.

Tools

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.
get_comments
Retrieve comments for an entry with filtering by status (active, resolved, all).
create_comment
Create new comments on entries with support for plain-text and rich-text formats. Supports threaded conversations by providing a parent comment ID.
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 body 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, references, and required fields.
list_assets
List assets with pagination (3 items per page).
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.
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.
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.
publish_content_type
Publish a content type.

Setup

  1. Create a Contentful account at https://www.contentful.com/.
  2. Generate a Content Management API token from your account settings.
  3. Add the following configuration to your Claude Desktop config file (e.g., ~/Library/Application Support/Claude/claude_desktop_config.json):

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

  1. Restart Claude Desktop.
claude_desktop_config.json
{
  "mcpServers": {
    "contentful": {
      "command": "npx",
      "args": [
        "-y",
        "@ivotoby/contentful-management-mcp-server"
      ],
      "env": {
        "CONTENTFUL_MANAGEMENT_ACCESS_TOKEN": "<Your CMA token>"
      }
    }
  }
}

Fit and risk

Best for

  • Developers using Claude Desktop or other MCP clients to manage Contentful content.
  • Teams needing to automate content publishing, batch updates, or validation.
  • Non-technical users who want to interact with Contentful content through a chat interface.

Not for

  • Users requiring official support (this server is community-driven, not officially supported by Contentful).
  • Scenarios needing to list more than 3 items per page without pagination.
  • Users who cannot provide a management token (unless using App Identity authentication).

Required permissions

  • Contentful Management API token with read and write permissions for content, spaces, environments, content types, etc.
  • Ability to create, update, delete, publish, and unpublish entries and assets.
  • Ability to create, update, and delete comments.
  • Ability to create and delete environments.
  • Ability to modify content type definitions.

Risks and side effects

  • This MCP server allows AI agents to update, delete content, spaces, and content models, which could lead to accidental data loss or modification.
  • Exposure of the management token could lead to unauthorized access.
  • Community server may be less stable or secure than an official one.

Troubleshooting

  1. Check that the environment variable CONTENTFUL_MANAGEMENT_ACCESS_TOKEN is set correctly, or pass the token via the --management-token argument.
  2. Ensure network connectivity to the Contentful API is established.
  3. If using HTTP mode, check that the port is free and the client is configured with the correct server URL.
  4. If list operations return only 3 items, that is expected behavior; use the provided pagination parameters to fetch more.

Use cases

Manage content in a Contentful space via natural language, such as creating, updating, publishing entries.
Perform bulk operations on large numbers of entries or assets, such as bulk publishing or validation.
Manage comments and threaded discussions in a content editing workflow.

Supported clients

Claude DesktopFull support