Contentful MCP Server

Official Contentful MCP server: entries, content types, assets, locales and AI Actions via the Management API

MCP serverHigh risk

contentful/contentful-mcp-server

Install

{
  "mcpServers": {
    "contentful-mcp": {
      "command": "npx",
      "args": ["-y", "@contentful/mcp-server"],
      "env": {
        "CONTENTFUL_MANAGEMENT_ACCESS_TOKEN": "your-CMA-token",
        "SPACE_ID": "your-space-id",
        "ENVIRONMENT_ID": "master",
        "CONTENTFUL_HOST": "api.contentful.com"
      }
    }
  }
}

Works in Claude Desktop, Cursor and other clients.

This is third-party code. Review the repository files before installing.

What it does

The server lets the agent work with the Contentful headless CMS. The agent searches entries, including by meaning, and creates, edits, publishes and unpublishes entries and assets. It changes the content model, creates environments, locales and tags, and resolves draft preview URLs. It can also create and run AI Actions, for example for translation. Environments can be write-protected with PROTECTED_ENVIRONMENTS.

Who it is for. For content teams and developers who run a site or app on Contentful.

Good fit when

  • You need to update fields across many entries
  • You need to add a field to a content type and fill it
  • You need to upload and organize campaign images

Not a fit when

  • Your site runs on another CMS
  • You cannot risk edits in the main environment without protection

Example request

Add a rating field to the product content type and fill it for all published products

Limitations

Requires a Contentful account, a Space ID and a Management API personal access token. Environment protection works only inside the server and does not replace Contentful roles. Contentful has restricted service for users in Russia, so access without a VPN is not guaranteed.

How to disable. Remove the contentful-mcp block from the client config and revoke the personal access token in Contentful settings.

MCP

Transport
stdio
Authentication
API key
Environment variables
Environment variables
CONTENTFUL_MANAGEMENT_ACCESS_TOKEN
required, secret
Management API personal access token
SPACE_ID
required
Contentful space ID
ENVIRONMENT_ID
Environment, default master
PROTECTED_ENVIRONMENTS
Comma-separated environments where writes and deletes are blocked
CONTENTFUL_HOST
API host, default api.contentful.com

Security check

  • Publishes and deletes content on a live site
  • Changes the content model and environments

README in short

The README covers one-click install for Cursor, a .dxt file for Claude Desktop, a Codex command and building from source. It includes an environment variable table and details on environment protection. Tools are grouped by content types, entries, assets, environments, previews, locales, tags and AI Actions. MIT licensed.

FAQ

How do I keep the agent out of the main environment?

List environments in PROTECTED_ENVIRONMENTS, e.g. master,staging. Reads still work while writes and deletes are blocked.

How do I install it in Codex?

Use codex mcp add contentful with env vars and npx -y @contentful/mcp-server; the README has an example.

Marketing Skills for AI agents

Marketing Skills for AI Agents

Editors’ pick

About fifty skills for CRO, copywriting, SEO, analytics, ads and launches, built for coding agents

SkillLow risk50.3K
Editors’ pick

A skill that strips AI writing tells from text using Wikipedia's list, without adding invented facts

SkillLow risk48.2K

Content skills: article illustrations, covers, infographics, comics, translation, URL to Markdown and social posting

SkillHigh risk25.9K

The Chinese version of Humanizer: finds and removes signs of AI writing in Chinese text

SkillLow risk17.3K