contentful/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
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:
bash
codex mcp add contentful --env CONTENTFULMANAGEMENTACCESSTOKEN="your-CMA-token" --env SPACEID="your-space-id" --env ENVIRONMENTID="master" --env CONTENTFULHOST="api.contentful.com" -- npx -y @contentful/mcp-server
#### Install from source
bash
git clone https://github.com/contentful/contentful-mcp-server.git
cd contentful-mcp-server
npm install
npm run build
### Environment Variables
| Environment Variable | Required | Default Value | Description |
| CONTENTFULMANAGEMENTACCESSTOKEN | ✅ Yes | - | Your Contentful Management API personal access token |
| SPACEID | ✅ Yes | - | Your Contentful Space ID |
| ENVIRONMENTID | ❌ No | master | Target environment within your space |
| PROTECTEDENVIRONMENTS | ❌ No | - | Comma-separated environment IDs blocked from write/delete operations (e.g. master,staging). See Protected environments. |
| CONTENTFULHOST | ❌ No | api.contentful.com | Contentful API host |
| EXPORTBASEDIR | ❌ No | process.cwd() | Server-controlled root directory for exportspace output |
| NODEENV | ❌ No | production | Node Environment to run in |
### Protected environments
Set PROTECTEDENVIRONMENTS 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, searchentries) are unaffected.
bash
PROTECTEDENVIRONMENTS=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.