CONTENT MANAGEMENT / Contentful
Contentful MCP
Read and manage Contentful entries, assets, content types and environments through its local MCP server.
“Contentful MCP Server”
01 / THE REASONING
Why this made the selection.
- Exposes structured CMS operations rather than treating a content space as an unstructured document store.
- Entry, asset and content-type tools support editorial maintenance and content-model work.
02 / THE REVIEW RECORD
What we actually inspected.
Source review has boundaries.
A clear record is more useful than a “safe” badge.
Material inspected
- Pinned package README, package.json and package MIT licence.
- Server entrypoint, environment parsing, tool registration and publishEntry implementation.
Our findings
- The TypeScript server uses stdio and Contentful Management API credentials.
- The source includes bulk limits and optional protected environments, but these do not make all tools read-only or replace token permissions.
- The package README’s sample configuration is an mcpServers block that launches npx -y @contentful/mcp-server with CONTENTFUL_MANAGEMENT_ACCESS_TOKEN, SPACE_ID, ENVIRONMENT_ID and CONTENTFUL_HOST in env, using placeholder values.
- The README tool table at this commit adds release tools (create, publish, unpublish, schedule and cancel releases) and space migration tools including export_space and import_space. export_space writes files under EXPORT_BASE_DIR, which defaults to the process working directory.
Not established by this review
- Server launch, authenticated tool calls, and release-to-source parity were not tested.
The review applies to the material and revision named here. A newer upstream release can change its behavior.
03 / PUT IT TO WORK
Connect a server deliberately.
DOCUMENTED COMMAND
npx -y @contentful/mcp-server Copying does not execute this command. It may retrieve a newer version than the reviewed source.
- Use the documented npx package configuration for your MCP client.
- Set CONTENTFUL_MANAGEMENT_ACCESS_TOKEN and SPACE_ID via protected client environment settings, then choose the intended ENVIRONMENT_ID.
- Start with a development environment and review content publishing, deletion and migration requests.
- The README gives no one-line install command. The command above is the sample configuration’s command and args (npx with -y @contentful/mcp-server); it was not run.
Before you start
- Node.js and npm/npx.
- Contentful account, space access and a Management API personal access token.
Documented configuration example
Use the client and authentication context described in the setup guidance. Configuration formats vary between hosts.
{
"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"
}
}
}
} 04 / FOLLOW THE EVIDENCE
The source trail.
Our notes are separate from the original resource.
Check upstream before adopting a new version.
https://raw.githubusercontent.com/contentful/contentful-mcp-server/a59daca4207eda1239fe3ffdb5849386ba17fdbc/packages/mcp-server/README.md
Supports: summary, upstreamDescription, whySelected, bestFor, limitations, install, access, compatibility, transports, review, configExample, Release and space migration tools, EXPORT_BASE_DIR
- Contentful MCP package ↗Checked
https://raw.githubusercontent.com/contentful/contentful-mcp-server/a59daca4207eda1239fe3ffdb5849386ba17fdbc/packages/mcp-server/package.json
Supports: language, install
https://raw.githubusercontent.com/contentful/contentful-mcp-server/a59daca4207eda1239fe3ffdb5849386ba17fdbc/packages/mcp-server/src/index.ts
Supports: review, transports
https://raw.githubusercontent.com/contentful/contentful-mcp-server/a59daca4207eda1239fe3ffdb5849386ba17fdbc/packages/mcp-server/src/tools/register.ts
Supports: review, limitations, access
https://raw.githubusercontent.com/contentful/contentful-mcp-server/a59daca4207eda1239fe3ffdb5849386ba17fdbc/packages/mcp-tools/src/tools/entries/publishEntry.ts
Supports: review, access
- Contentful MCP MIT licence ↗Checked
https://raw.githubusercontent.com/contentful/contentful-mcp-server/a59daca4207eda1239fe3ffdb5849386ba17fdbc/packages/mcp-server/LICENSE
Supports: license