stackgate.ai
All integrations

Contentful

Connect Claude, ChatGPT or Cursor to Contentful via MCP. Read spaces, content types, entries, and assets with a CMA personal access token.

Manual setup 7 tools

Example questions

Try asking your AI client

  • Which Contentful entries in Blog are still in draft?

  • Did the homepage hero entry ever get published after last week's review?

  • Write a draft outline for a new changelog entry about the feature Amalie shipped - do not create it.

  • List content types in the marketing space and how many entries each has.

  • Find the asset we used for the June campaign banner.

Overview

Connect Contentful so AI clients can browse spaces, content types, entries, and assets via the Content Management API.

This integration is read-first: list, get, and search tools only. Publishing entries or uploading assets is not included.

Prerequisites

  • A Contentful space you can manage
  • Permission to create a Content Management API (CMA) personal access token
  • A stackgate.ai account

Getting credentials

  1. Sign in to Contentful.
  2. Open Settings → CMA tokens (or Settings → API keys → Content management tokens).
  3. Create a personal access token and copy it immediately. Content Delivery API tokens cannot list spaces.
  4. Optionally copy a default space ID from the space settings URL or the space switcher.
  5. In stackgate.ai, open My Integrations → Contentful.
  6. Paste the token, optionally set the default space and environment (master is the default), and save. stackgate.ai verifies the token against Contentful's /spaces endpoint.
  7. EU data residency spaces should set API base URL to https://api.eu.contentful.com.
  8. Optionally use Edit tool access to keep a subset of read tools.

See Contentful authentication and the Content Management API.

Using with AI clients

  • Dedicated endpoint: POST /mcp/contentful with a Sanctum bearer token
  • Private gateway: one config for all integrations - use contentful__* namespaced tools

Example prompts:

  • "List my Contentful spaces."
  • "Show content types in space space123."
  • "Search Contentful entries for pricing."
  • "Get the Hero image asset metadata."

Troubleshooting

  • 422 integration not configured - complete the personal access token form in My Integrations.
  • 401 Unauthorized - regenerate the CMA personal access token and update My Integrations. Delivery API tokens will not work.
  • 403 Forbidden - the token cannot manage the requested space or environment.
  • 404 Not found - confirm the space ID, environment ID (master unless you use a named environment), and entry or asset ID.
  • 429 Too many requests - Contentful allows about 10 CMA requests per second per space. Retry after a short delay.
  • EU residency - set API base URL to https://api.eu.contentful.com if the space lives in the EU region.

Available tools

  • list_spaces

    List Contentful spaces accessible to the connected personal access token.

  • list_content_types

    List content types in a Contentful space environment.

  • list_entries

    List Contentful entries, optionally filtered by content type, with skip/limit pagination.

  • search_entries

    Full-text search Contentful entries in a space environment.

  • get_entry

    Get a Contentful entry by ID, including fields and sys metadata.

  • list_assets

    List Contentful assets (media) in a space environment.

  • get_asset

    Get Contentful asset metadata by ID, including title, description, and file URL.

MCP endpoint: https://stackgate.ai/mcp/contentful (HTTP) or via the private gateway.

Create account Documentation