Contentful GraphQL

MCP Server to enable LLM's to connect to the Contentful GraphQL Endpoints

typescript

1

GitHub Stars

typescript

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "ivo-toby-contentful-mcp-graphql": {
      "command": "npx",
      "args": [
        "-y",
        "@ivotoby/contentful-graphql-mcp-server"
      ],
      "env": {
        "SPACE_ID": "<Your Space ID>",
        "ENVIRONMENT_ID": "master",
        "CONTENTFUL_DELIVERY_ACCESS_TOKEN": "<Your CDA token>"
      }
    }
  }
}

You can run a Contentful GraphQL MCP Server to query Contentful content efficiently via GraphQL, explore your schema, and generate helpful example queries. This server connects to Contentful’s CDA endpoint and exposes a GraphQL interface you can consume from MCP clients, tools, or your own integrations.

How to use

Start the MCP server in stdio mode to connect via your preferred MCP client. You can run it with environment variables or pass credentials as command-line arguments. Once running, you can list content types, inspect a content type schema, generate example queries, and execute custom queries against Contentful’s GraphQL API. Use your token and space information to access your Contentful space in a secure, read-only fashion.

How to install

Prerequisites you need installed on your system before you begin:

Node.js and npm or a compatible runtime for the MCP server commands in your environment

Configuration

The MCP server uses a Content Delivery API (CDA) token, your Contentful Space ID, and an environment ID to operate. You can pass these values either as environment variables or as explicit command-line arguments when starting the server.

Environment variables you may use (examples shown):

Examples

Basic usage in stdio mode: run the MCP server with the minimum arguments and no real tokens shown here. Replace placeholders with your actual values.

GraphQL tools and capabilities

The server provides core GraphQL capabilities to help you work with Contentful data more efficiently.

Troubleshooting

If you encounter authentication failures, verify that your CDA token is valid for the targeted space and environment. Check that the space ID is correct and that the token has read-only access suitable for GraphQL operations.

Security and access control

The server operates with read-only access using CDA tokens. Tokens are scoped to a specific space and environment, and input queries are validated before execution to prevent unsafe operations.

Available tools

List Content Types

Discover all available GraphQL query collections in your Contentful space's GraphQL schema.

Get Content Type Schema

Retrieve detailed schema information for a specific content type, including fields and relationships.

Get Example Query

Generate example GraphQL queries for a given content type to help you start.

Execute Query

Run a custom GraphQL query against Contentful's GraphQL API and return results.