Contentful MCP Server
Official Contentful MCP server: entries, content types, assets, locales and AI Actions via the Management API
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 productsLimitations
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 | |
|---|---|
| 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.
Related
Marketing Skills for AI agents
Marketing Skills for AI Agents
About fifty skills for CRO, copywriting, SEO, analytics, ads and launches, built for coding agents
A skill that strips AI writing tells from text using Wikipedia's list, without adding invented facts
Content skills: article illustrations, covers, infographics, comics, translation, URL to Markdown and social posting
The Chinese version of Humanizer: finds and removes signs of AI writing in Chinese text