Contentful MCP Server

A Model Context Protocol (MCP) server that provides AI assistants with comprehensive tools to interact with Contentful APIs.

🚀 Example Use Cases

This MCP server provides a comprehensive set of tools for content management, allowing AI to help you create, edit, organize, and publish content directly within Contentful. Once configured, you can use natural language in your AI assistant of choice to manage and interact with your Contentful spaces, including:

• Content Creation: "Create a new blog post for our fall product launch"

• Content Management: "Update all product entries to include the new pricing structure"

• Asset Organization: "Upload and organize these marketing images by campaign"

• Workflow Automation: "Create an AI action that translates content to Spanish"

• Content Modeling: "Add a new field to the product content type for customer ratings"

Related MCP server: Confluence MCP

📓 Table of Contents

• ⚙️ Getting Started

  • Prerequisites

  • Installation

  • Environment Variables

  • Protected environments

  • Configuration

• 🛠️ Available Tools

• 🔍 Development

  • Testing with MCP Inspector

• 📦 Releases

• 🤝 Contributing and development

• 📚 Documentation

• ❓ Help & Support

• 📄 License and Notices

• 🛡️ Code of Conduct

⚙️ Getting started

Prerequisites

• Node.js

• npm

• A Contentful account with a Space ID

• Contentful Management API personal access token

Installation

One-Click install

Note: This requires Cursor to be installed. If the link doesn't work, try the manual installation below.

Claude Desktop:

Download the .dxt configuration file here from the latest release and import it into Claude Desktop to automatically configure the MCP server with your environment variables.

Codex:

codex mcp add contentful --env CONTENTFUL_MANAGEMENT_ACCESS_TOKEN="your-CMA-token" --env SPACE_ID="your-space-id" --env ENVIRONMENT_ID="master" --env CONTENTFUL_HOST="api.contentful.com" -- npx -y @contentful/mcp-server

Install from source

git clone https://github.com/contentful/contentful-mcp-server.git
cd contentful-mcp-server
npm install
npm run build

Environment Variables

Protected environments

Set PROTECTED_ENVIRONMENTS to a comma-separated list of environment IDs (e.g. master,staging) to block write and delete tool calls targeting those environments. Reads (get_*, list_*, search_entries) are unaffected.

PROTECTED_ENVIRONMENTS=master,staging

When the guard fires, the tool returns a clear error and never reaches the Contentful API:

Environment 'master' is protected. Write and delete operations are not allowed.

Notes:

• Opt-in. Unset (or only commas/whitespace) means no environments are protected — existing behavior is unchanged.

• Case-sensitive. Environment IDs in Contentful are case-sensitive, so master and Master are different. Match the exact ID you want to protect.

• MCP boundary only. The guard runs inside this server. Direct CMA SDK calls, the Contentful web app, and other clients are not affected — use this alongside, not instead of, role-based permissions.

• Covers env-scoped writes. Org-scoped resources (concepts, concept schemes) and read-only tools have no environment to check, so the guard does not apply. invoke_ai_action is also unguarded — invocation generates content but doesn't write to the environment; any follow-up write the agent performs is still blocked.

Configuration

Refer to the documentation for your AI tool of choice for how to configure MCP servers. For example, see the documentation for Codex, Cursor, VS Code, or Claude Desktop.

Below is a sample configuration:

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

🛠️ Available Tools

🤝 Contributing and Development

We welcome contributions! Please see our Contributing Guide for local development setup and contribution guidelines.

📦 Releases

This project uses Nx Release for automated versioning and publishing. Releases are automatically generated based on Conventional Commits. See Contributing Guide for more information on release process.

See github releases and npm

📚 Documentation

• Model Context Protocol Documentation

• Contentful Management API Documentation

❓ Help & Support

• Contentful support resources

• Report bugs or request features

• Contentful Community Discord

📄 License and Notices

This project is licensed under the MIT License. See LICENSE for details.

It also includes open-source components licensed under MIT, BSD-2-Clause, and Apache-2.0. For details, see the NOTICE file.

This project includes an automated license management system that keeps track of all dependencies and their licenses. See the AUTOMATION-FOR-LICENSES file for more information.

🛡️ Code of Conduct

We want to provide a safe, inclusive, welcoming, and harassment-free space and experience for all participants, regardless of gender identity and expression, sexual orientation, disability, physical appearance, socioeconomic status, body size, ethnicity, nationality, level of experience, age, religion (or lack thereof), or other identity markers.

Read our full Code of Conduct.

For AI Agents

If you are an AI coding agent working in this repository, read AGENTS.md first. It tells you where to find architectural context, development setup, decision records, and repo-specific rules.