Contentful MCP Server

Community

An MCP server for the Contentful Management API, enabling comprehensive content management capabilities.

How to install ↓ Compare GitHub source repository ↗

Category: Cloud Storage #7 of 15
Stars: ★ 62 Popular
Transport: stdio (local process) · Streamable HTTP
Runtime: Node.js
Credentials: API key / credential required
License: MIT
Last commit: 9 months ago ⚠
Tools: 33

58FMRS · C

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.

Strongest · Documentation 15/20 Weakest · Reliability 8/20

Reliability

8/20

Security and permissions

10/20

Maintenance

12/20

Documentation

15/20

Setup experience

13/20

Why each score

Reliability 8/20: The source contains tool definitions and primary execution paths, but no verifiable tests or CI results are present, so actual runtime stability cannot be confirmed. Due to static review limitations, no code execution was performed, hence the reliability score is below full marks.
Security and permissions 10/20: The README emphasizes warnings about destructive operations and supports scoping via space and environment IDs to limit operations. However, no explicit confirmation mechanism is evident, and some operations (e.g., delete, publish) have high side effects, requiring further hardening.
Maintenance 12/20: The repository is not archived and has open issues, but recent commits and release information cannot be retrieved from static source. MIT license exists, but no clear maintainer ownership or update policy is visible, so maintenance score is moderate.
Documentation 15/20: The README provides detailed installation, configuration examples, and a tool list, covering environment variables and parameters. However, lacking specific troubleshooting and error handling documentation, as well as cost information, documentation is good but not perfect.
Setup experience 13/20: The README provides clear step-by-step installation guides, including Claude Desktop configuration examples and multiple transport modes. However, no setup script or automated verification for common issues is present, and users must manually obtain API tokens; installation steps are relatively straightforward but could be improved.

Static review · not runListed 2026-08-07

Read the FMRS scoring method →

Fit and risk

What it can accessUses the networkChanges third-party account data

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.

Setup

Before you start

Runtime：Node.js

CONTENTFUL_MANAGEMENT_ACCESS_TOKEN requiredsecret Contentful Management API (CMA) token, generated from your account settings' API keys page; required for the server to run.

Other optional settings (7)

CONTENTFUL_HOST optional Contentful Management API endpoint, defaults to https://api.contentful.com.

ENABLE_HTTP_SERVER optional Set to "true" to enable HTTP/SSE transport mode.

HTTP_PORT optional Port for the HTTP server, default 3000.

HTTP_HOST optional Host for the HTTP server, default localhost.

DISABLE_AI_ACTIONS optional Set to "true" to disable fetching AI Actions on startup (useful without access to that feature).

SPACE_ID optional Optional; scopes operations to a single space.

ENVIRONMENT_ID optional Optional; set together with SPACE_ID so tools no longer ask for space/environment IDs.

Create a Contentful account at https://www.contentful.com/.
Generate a Content Management API token from your account settings.
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>"
}
}
}
}

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>"
      }
    }
  }
}

Shown for Claude Desktop. Other clients may use a different file or key (VS Code uses "servers") — the configurator below converts it.

.vscode/mcp.json

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

Goes in your project's .vscode/mcp.json (VS Code uses a "servers" key).

Terminal

claude mcp add contentful -e 'CONTENTFUL_MANAGEMENT_ACCESS_TOKEN=<Your CMA token>' -- npx -y @ivotoby/contentful-management-mcp-server

Run it in a terminal; replace any <…> placeholders with your own values first.

Generate and validate client config

Check that it works

After adding the server to claude_desktop_config. and restarting the client, tools like search_entries and list_spaces should appear in the tool list; asking 'List my Contentful spaces' proves the connection works.

Troubleshooting

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

Things to try

Once connected, you can ask your AI assistant things like:

Search entries whose title contains 'news' and show the first results
Create a comment on entry entryId 123 saying 'Reviewed'
Bulk publish these entries and assets for me
List all environments in my current space

Tools 33

search_entries read-only

Search for entries using query parameters.

create_entry writes

Create new entries.

get_entry read-only

Retrieve existing entries.

update_entry writes

Update entry fields.

delete_entry destructive

Remove entries.

publish_entry writes

Publish entries.

unpublish_entry writes

Unpublish entries.

get_comments read-only

Retrieve comments for an entry with filtering by status (active, resolved, all).

Show 25 more tools

create_comment writes

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 read-only

Retrieve a specific comment by its ID for an entry.

delete_comment destructive

Delete a specific comment from an entry.

update_comment writes

Update existing comments with new body content or status changes.

bulk_publish writes

Publish multiple entries and assets in a single operation.

bulk_unpublish writes

Unpublish multiple entries and assets in a single operation.

bulk_validate read-only

Validate multiple entries for content consistency, references, and required fields.

list_assets read-only

List assets with pagination (3 items per page).

upload_asset writes

Upload new assets with metadata.

get_asset read-only

Retrieve asset details and information.

update_asset writes

Update asset metadata and files.

delete_asset destructive

Remove assets from space.

publish_asset writes

Publish assets to delivery API.

unpublish_asset writes

Unpublish assets from delivery API.

list_spaces read-only

List available spaces.

get_space read-only

Get space details.

list_environments read-only

List environments in a space.

create_environment writes

Create new environment.

delete_environment destructive

Remove environment.

list_content_types read-only

List available content types.

get_content_type read-only

Get content type details.

create_content_type writes

Create new content type.

update_content_type writes

Update content type.

delete_content_type destructive

Remove content type.

publish_content_type writes

Publish a content type.

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 Desktop

Listed from the project's documentation, not tested by this site.

Overview

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.

Similar servers

Google Search Console MCP Server 69 · C

Comprehensive access to Google Search Console via MCP, with advanced analytics and quick win detection.

★ 279 · Tools 1 Compare with this →

Nextcloud MCP Server 67 · C

A production-ready MCP server that connects AI assistants to your Nextcloud instance.

★ 385 · Tools 13 Compare with this →

reMarkable MCP Server 65 · C

Use your reMarkable tablet as a second brain for AI assistants. Read documents, browse files, extract text, and OCR handwriting.

★ 250 · Tools 13 Compare with this →

Microsoft 365 MCP Server 61 · C

An MCP server for interacting with Microsoft 365 and Office services through the Graph API.

★ 1.1k · Tools 10 Compare with this →

Compare with other MCP servers

Source revision 3f9069518471 Data synced 2026-10-19 Read the FMRS scoring method