← Explore all mcp servers

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.

Upstream setup instructions ↗

DOCUMENTED COMMAND

npx -y @contentful/mcp-server

Copying does not execute this command. It may retrieve a newer version than the reviewed source.

  1. Use the documented npx package configuration for your MCP client.
  2. Set CONTENTFUL_MANAGEMENT_ACCESS_TOKEN and SPACE_ID via protected client environment settings, then choose the intended ENVIRONMENT_ID.
  3. Start with a development environment and review content publishing, deletion and migration requests.
  4. 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.

  1. 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

  2. Contentful MCP package ↗Checked

    https://raw.githubusercontent.com/contentful/contentful-mcp-server/a59daca4207eda1239fe3ffdb5849386ba17fdbc/packages/mcp-server/package.json

    Supports: language, install

  3. https://raw.githubusercontent.com/contentful/contentful-mcp-server/a59daca4207eda1239fe3ffdb5849386ba17fdbc/packages/mcp-server/src/index.ts

    Supports: review, transports

  4. https://raw.githubusercontent.com/contentful/contentful-mcp-server/a59daca4207eda1239fe3ffdb5849386ba17fdbc/packages/mcp-server/src/tools/register.ts

    Supports: review, limitations, access

  5. https://raw.githubusercontent.com/contentful/contentful-mcp-server/a59daca4207eda1239fe3ffdb5849386ba17fdbc/packages/mcp-tools/src/tools/entries/publishEntry.ts

    Supports: review, access

  6. https://raw.githubusercontent.com/contentful/contentful-mcp-server/a59daca4207eda1239fe3ffdb5849386ba17fdbc/packages/mcp-server/LICENSE

    Supports: license

Evidence & Ask