Contentful MCP server for AI agents and assistants

Securely connect your AI agents and chatbots (Claude, ChatGPT, Cursor, etc) with Contentful MCP or direct API to fetch entries, create or update content, manage assets, and publish changes through natural language.

Contentful logoContentful
Oauth2Api Key

Contentful is a headless CMS for creating, managing, and distributing content via API. It's built for flexibility, letting teams publish anywhere from websites to apps with speed and consistency.

106 Tools

Try Contentful now

Type what you want done — sign in and watch it run live in the Tool Router playground.

TOOL ROUTER PLAYGROUND
Contentful
Try asking
TOOLS

Supported Tools

Every Contentful action and event your agent gets out of the box.

Activate Content Type

Activates (publishes) a content type in Contentful.

Archive Asset

Tool to archive an asset in Contentful.

Archive Entry

Tool to archive an entry in Contentful.

Archive Release

Tool to archive a release in Contentful.

Create App Signing Key

Tool to generate an app signing key for a Contentful app definition.

Create Content Type

Tool to create a new content type in a Contentful environment.

Create Entry Task

Tool to create a task on a Contentful entry.

Create Environment

Tool to create a new environment within a Contentful space.

Create App Access Grant

Creates an access grant for an app definition to allow organizations to install the app.

Create Organizations App Definitions

Tool to create a new app definition in a Contentful organization.

Create App Definition Action

Tool to create an action for a Contentful app definition.

Create Organization Invitation

Create an invitation to an organization in Contentful (alpha feature).

Create Organizations Security Contacts

Creates a security contact for a specific organization.

Create Organizations Taxonomy Concepts

Tool to create a new taxonomy concept in a Contentful organization.

Create Organizations Taxonomy Concept Schemes

Tool to create a new taxonomy concept scheme in an organization.

Create Release

Tool to create a new release in Contentful.

Create Delivery API Key

Tool to create a new Delivery API key for a Contentful space.

Create Asset

Tool to create a new asset in a Contentful space environment.

Create Entry

Tool to create a new entry in a Contentful space environment.

Create Entry Comment

Tool to create a comment on an entry in Contentful.

Create Extension

Tool to create a new UI extension within a Contentful space and environment.

Create Scheduled Action

Tool to create a scheduled action for publishing or unpublishing entries/assets in Contentful.

Delete Asset

Deletes an asset by ID from a Contentful environment.

Delete Content Type

Deletes a content type by ID from a Contentful environment.

Delete Entry

Deletes an entry by ID from a Contentful environment.

Delete Environment

Deletes an environment by ID from a Contentful space.

Delete Extension

Deletes an extension by ID from a Contentful environment.

Delete App Event Subscription

Deletes an app event subscription from a Contentful organization.

Delete App Definition Details

Tool to delete app definition details for an organization in Contentful.

Delete App Key

Tool to delete an app key from an app definition in a Contentful organization.

Delete App Definition Signing Secret

Tool to remove the current app signing secret from an app definition.

Delete Organization Security Contact

Deletes a security contact from a Contentful organization.

Delete Release

Deletes a release by ID from a Contentful environment.

Delete Scheduled Action

Cancels a scheduled action by ID in Contentful.

Delete Space Membership

Deletes a space membership by ID from a Contentful space.

Delete Delivery API Key

Tool to delete a single Delivery API key from a Contentful space.

Delete Spaces Upload

Deletes an upload by ID from a Contentful space.

Delete Tag

Deletes a tag by ID from a Contentful environment.

Get App Bundle

Retrieves details of a specific app bundle by its ID.

Get App Definition

Tool to retrieve details of a specific app definition by its ID.

Get Asset

Tool to retrieve a single asset from a Contentful environment by its ID.

Get Content Types

Retrieves all content types in a Contentful environment.

Get Content Type Snapshot

Tool to retrieve a snapshot of a content type by snapshot ID.

Get Content Type Snapshots

Tool to get all snapshots of a content type in Contentful.

Get Editor Interface

Tool to retrieve the editor interface configuration for a content type.

Get Entry Comment

Tool to retrieve a specific comment from an entry in Contentful.

Get Entry References

Tool to retrieve references to a specific entry in Contentful.

Get Entry Snapshots

Tool to get all snapshots of an entry in Contentful.

Get Environment

Tool to retrieve details of a specific environment by its ID within a space.

Get Organization

Retrieves details of a specific organization by its ID.

Get Organization Access Grant

Retrieves the access grant status for a specific organization.

Get Organizations

Tool to get all organizations an account has access to in Contentful.

Get Organizations AI Providers

Retrieves all AI providers configured for an organization in Contentful.

Get Organization App Actions Categories

Retrieves app action categories for a Contentful organization.

Get App Event Subscription

Tool to retrieve details of an app event subscription by organization and app definition ID.

Get Organizations App Definitions

Retrieves all app definitions for a specific organization.

Get Organizations App Definitions Access Grants

Get all app access grants for a specific app definition within an organization.

Get App Definition Actions

Tool to get all actions of an app definition within an organization.

Get App Action Details

Tool to read a specific app action from an app definition within an organization.

Get App Definition App Bundles

Tool to get all app bundles for a specific app definition within an organization.

Get App Definition Functions

Tool to get all functions of an app definition within an organization.

Get App Definition Keys

Tool to retrieve all app keys for a specific app definition in a Contentful organization.

Get App Definition Signing Secret

Tool to retrieve the current app signing secret for an app definition.

Get Organization Enablements

Retrieves feature enablements for a specific organization in Contentful.

Get Organization Invitation

Retrieves a single invitation for an organization (alpha).

Get Organization Periodic Usages

Tool to get organization periodic usage statistics.

Get Organization Roles

Retrieves all space roles in an organization.

Get Organization Security Contacts

Retrieves security contacts for a specific organization that an admin or owner has access to.

Get Organizations Space Enablements

Retrieves all space enablements for a specific organization.

Get Organizations Space Periodic Usages

Tool to retrieve space periodic usage data for an organization.

Get Organizations Taxonomy Concepts

Retrieves all taxonomy concepts for an organization in Contentful.

Get Taxonomy Concept Ancestors

Retrieves the list of ancestor concepts for a specific taxonomy concept.

Get Organizations Taxonomy Concept Schemes

Tool to retrieve all taxonomy concept schemes from an organization.

Get Taxonomy Concept Scheme

Tool to retrieve a specific taxonomy concept scheme from an organization.

Get Organizations Taxonomy Concept Schemes Total

Retrieves the total count of taxonomy concept schemes for a specific organization.

Get Organizations Taxonomy Concepts Total

Retrieves the total count of taxonomy concepts for a specific organization.

Get Release

Tool to get a single release by ID from Contentful.

Get space

Retrieves metadata of a specific space by its ID.

Get Space Memberships

Tool to get all space memberships in a Contentful space.

Get Delivery API Keys

Tool to retrieve all Delivery API keys for a specific Contentful space.

Get Space Environments

Retrieves all environments of a space in Contentful.

List App Installations

Lists all app installations in a specific Contentful environment.

Get All Assets

Retrieves all assets from a specific environment in a Contentful space.

Get Space Environment Locales

Tool to retrieve all locales of a space environment in Contentful.

Get App Installation Functions

Tool to get all functions for an app installation in a Contentful environment.

Get Authenticated User

Tool to retrieve information about the currently authenticated user.

List Entries

Tool to retrieve all entries from a Contentful space environment.

List spaces

Lists all spaces that the authenticated user has access to in Contentful.

Get All Space Roles

Tool to retrieve all roles from a Contentful space.

Publish Entry

Tool to publish an entry in Contentful, making it available via the Content Delivery API.

Query Asset Collection

Tool to retrieve multiple assets with pagination and filtering via GraphQL API.

Query GraphQL Content Type Collection

Tool to query a collection of entries for a specific content type using GraphQL.

Update App Definition

Tool to update an app definition by ID in a Contentful organization.

Update Editor Interface

Tool to update the editor interface configuration for a content type.

Update Entry

Tool to create or update an entry in a Contentful space environment.

Update App Event Subscription

Tool to update or create an app event subscription in a Contentful organization.

Update App Definition Action

Tool to update an action for a Contentful app definition.

Update App Definition Details

Tool to create or update app definition details for an organization in Contentful.

Update App Definition Signing Secret

Tool to create or overwrite the app signing secret for an app definition.

Update Organization Enablements

Updates feature enablements for a specific organization in Contentful.

Update Organization Security Contact

Updates an organization security contact that an admin or owner has access to.

Update Organizations Taxonomy Concepts

Tool to create or update a taxonomy concept with a user-defined ID in a Contentful organization.

Update Organizations Taxonomy Concept Schemes

Tool to create or update a taxonomy concept scheme with a user-defined ID in an organization.

Update space

Updates the name of a specific space.

Update Tag

Creates or updates a tag in a Contentful environment.

Validate Bulk Action

Tool to validate a bulk action before executing it.

SETUP GUIDE

Connect Contentful MCP Tool with your Agent

1

Install Composio

typescript
npm install @composio/core ai @ai-sdk/mcp @ai-sdk/openai
Install the Composio SDK and your agent framework
2

Create a session with MCP enabled

typescript
import { Composio } from "@composio/core";

const composio = new Composio();
const { mcp } = await composio.create("your-user-id", {
  toolkits: ["contentful"],
  mcp: true,
});
Create a session scoped to Contentful and read its MCP URL and headers
3

Connect your agent to the MCP server

typescript
import { createMCPClient } from "@ai-sdk/mcp";
import { openai } from "@ai-sdk/openai";
import { generateText, stepCountIs } from "ai";

const client = await createMCPClient({
  transport: { type: "http", url: mcp.url, headers: mcp.headers },
});

const { text } = await generateText({
  model: openai("gpt-5.6-sol"),
  tools: await client.tools(),
  prompt: "List all Contentful spaces I have access to",
  stopWhen: stepCountIs(10),
});

console.log(text);
await client.close();
Pass the session's MCP URL and headers to your agent and run a Contentful request
SETUP GUIDE

Connect Contentful API Tool with your Agent

1

Install Composio

typescript
npm install @composio/core @composio/openai openai
Install the Composio SDK, the OpenAI provider, and the OpenAI SDK
2

Create a Composio session

typescript
import OpenAI from "openai";
import { Composio } from "@composio/core";
import { OpenAIResponsesProvider } from "@composio/openai";

const composio = new Composio({ provider: new OpenAIResponsesProvider() });
const client = new OpenAI();

const session = await composio.create("your-user-id", { toolkits: ["contentful"] });
const tools = await session.tools();
Initialize Composio with the OpenAI Responses provider and create a session scoped to Contentful
3

Run Contentful tools with your agent

typescript
let response = await client.responses.create({
  model: "gpt-5.6-sol",
  tools,
  input: [{ role: "user", content: "List all Contentful spaces I have access to" }],
});

while (response.output.some((o) => o.type === "function_call")) {
  const outputs = await composio.provider.handleToolCalls(session, response.output);
  response = await client.responses.create({
    model: "gpt-5.6-sol",
    tools,
    previous_response_id: response.id,
    input: outputs,
  });
}

console.log(response.output_text);
Send a request, execute the Contentful tool calls through the session, and print the final answer

Why Use Composio?

AI Native Contentful Integration

  • Supports both Contentful MCP and direct API based integrations
  • Structured, LLM-friendly schemas for reliable tool execution
  • Rich coverage for reading, writing, and querying your Contentful data

Managed Auth

  • Built-in OAuth handling with automatic token refresh and rotation
  • Central place to manage, scope, and revoke Contentful access
  • Per user and per environment credentials instead of hard-coded keys

Agent Optimized Design

  • Tools are tuned using real error and success rates to improve reliability over time
  • Comprehensive execution logs so you always know what ran, when, and on whose behalf

Enterprise Grade Security

  • Fine-grained RBAC so you control which agents and users can access Contentful
  • Scoped, least privilege access to Contentful resources
  • Full audit trail of agent actions to support review and compliance

Rolling this out across your team?

Give your team centralized access control across every framework with Composio’s MCP Gateway.

EXPLORE MCP GATEWAY
FAQ

Frequently asked questions

No. Composio provides a managed OAuth app for Contentful, so you sign in with your normal Contentful account and approve access. If you later want the consent screen to show your own company name, you can add your own Contentful OAuth app in the Composio dashboard, and every connection after that uses it.

Yes! Composio's Tool Router enables agents to use multiple toolkits. Learn more.

Yes. Composio is SOC 2 Type II compliant and is built to keep your Contentful connection and credentials secure. OAuth tokens and API keys are encrypted, and sensitive customer data is protected at rest and in transit.

Composio also undergoes independent security testing and continuously monitors its systems for security threats. You can review the latest reports and policies in the Composio Trust Center.

Composio maintains and updates all toolkit integrations automatically, so your agents always work with the latest API versions.

When you connect a Contentful account through Composio, every action runs under that account, so anything the agent creates, sends, or changes shows up in Contentful as done by you. Keep an approval step in your prompt for actions with side effects, such as sending or deleting, and have the agent draft first.

Exactly the ones Contentful lists on its consent screen when you connect. Review that screen before approving. If you connect a work account, your Contentful administrator may need to approve the app first, and you can revoke the access inside Contentful whenever you want.

Yes. Composio supports multiple connected accounts for the same app, and that works in Claude, ChatGPT, or any other assistant you connect through Composio. Give each Contentful connection a name such as work or personal, and the assistant uses the one you mention in the request. Each account keeps its own credentials and nothing is merged.

Composio refreshes Contentful tokens automatically, so day to day you do nothing. If you revoke access inside Contentful, or Contentful invalidates the session, the connection shows as expired in Composio and the agent stops acting on that account until you reconnect it, which is a single sign-in.

Composio's free Hobby plan includes 100,000 tool calls per month with no credit card, and up to 20,000 of those can run through Composio-managed apps like Contentful. Personal Contentful use rarely gets near that. Paid plans add higher limits and team features, and Contentful's own pricing is unaffected.

Built-in connectors usually give one AI access to a limited set of apps. Many people use Composio because it lets their AI connect to more apps than it normally supports, or connect to multiple accounts for the same app (e.g. connect Claude to multiple Contentful accounts).

With Composio, you connect Contentful once and then use it across different AI assistants without setting it up separately in each one. Connect your apps to Composio once, then connect Composio to whichever AI you use, whether that's Claude, ChatGPT, Hermes, or your own custom assistant.

Start with Contentful.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Contentful tool your agent needs.Free to start.

Start building