Contentful MCP Server for Claude

Overview

The Contentful MCP Server is the official Model Context Protocol server from Contentful, the leading headless CMS. It gives Claude full access to the Contentful Management API — creating, updating, publishing, and deleting entries, assets, content types, locales, spaces, and environments using natural language. Also supports Contentful AI Actions for custom AI-powered workflows and vector-based semantic_search for meaning-based content discovery. Licensed under MIT.

Key capabilities

• Entries — create, search, get, update, publish, unpublish, delete; semantic vector search.
• Assets — upload, list, get, update, publish, unpublish, delete marketing images and files.
• Content types — create, update, publish, unpublish, delete content models.
• Spaces & environments — list spaces, create/delete environments, manage locales.
• AI Actions — create, invoke, and manage Contentful's built-in AI workflow actions.
• Protected environments — block writes to specified environments (e.g. master) to prevent accidental changes.

Tools (40+)

How it compares

Contentful's semantic_search tool enables vector-based meaning search over entries — not just keyword filtering — making it the only headless CMS MCP server with native AI-powered content discovery.

Installation

Claude Code

claude mcp add contentful \
  -e CONTENTFUL_MANAGEMENT_ACCESS_TOKEN=your-cma-token \
  -e SPACE_ID=your-space-id \
  -- npx -y @contentful/mcp-server

Claude Desktop

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

Protecting environments

Add PROTECTED_ENVIRONMENTS=master,staging to block write/delete operations on those environments.

Requirements

• A Contentful account with Space ID and CMA personal access token.
• Node.js with npx.
• An MCP client (Claude Code or Claude Desktop).

Security

• Use PROTECTED_ENVIRONMENTS to prevent accidental writes to master or other sensitive environments.
• CMA tokens have full read/write access — scope to least privilege if possible.

Source Verification Notes

Verified on 2026-06-18:

• Official GitHub repository contentful/contentful-mcp-server (MIT, 58 stars) documents the @contentful/mcp-server npm package, the CONTENTFUL_MANAGEMENT_ACCESS_TOKEN, SPACE_ID, ENVIRONMENT_ID, and PROTECTED_ENVIRONMENTS config, all 40+ tools across entries/assets/content-types/spaces/locales/AI-actions, and the Claude Desktop .dxt release artifact.
• Claude Code MCP documentation at code.claude.com/docs/en/mcp describes the stdio connector setup pattern used above.