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"

📓 Table of Contents

• ⚙️ Getting Started
  • Prerequisites
  • Installation
  • Environment Variables
  • Configuration
• 🛠️ Available Tools
• 🔍 Development
  • Testing with MCP Inspector
  • Linting
• 📦 Releases
• 🤝 Contributing
  • Development Setup
• 📚 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

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

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

---