Contentful MCP server

Connect Contentful to Claude, ChatGPT, Cursor, Claude Code, Codex, Gemini, GitHub Copilot and any other MCP client, for your whole team. Metorial adds security, governance, and tracing, and gives everyone one Magic MCP URL to connect.

Deploy ContentfulBook a demo

What you can do with the Contentful MCP server

Ask your agent in plain language. Each of these maps to a real tool on the server.

  • Use the schedule action tool in Contentful
  • Use the create asset tool in Contentful
  • Use the update entry tool in Contentful
  • Use the list content types tool in Contentful
  • Use the list locales tool in Contentful
  • Use the manage asset lifecycle tool in Contentful

Supported Tools

schedule_action

Schedule Action

Schedule a future publish or unpublish action for an entry. Also supports listing and cancelling scheduled actions.

create_asset

Create Asset

Create a new asset in Contentful. Provide file upload URL, title, and description per locale. Optionally request processing and publish only after completion.

update_entry

Update Entry

Update an existing entry's fields. Fetches the current version automatically if not provided. Optionally publish the updated entry.

list_content_types

List Content Types

List all content types in the current environment. Returns content type names, field definitions, and configuration details.

list_locales

List Locales

List all configured locales in the current environment. Returns locale codes, names, and fallback configuration.

manage_asset_lifecycle

Manage Asset Lifecycle

Perform lifecycle actions on an asset: publish, unpublish, archive, unarchive, or delete. Fetches the current version automatically if not provided.

sync_content

Sync Content

Perform a content sync via the Content Delivery API. Fetch one page of an initial sync, or provide a sync token to retrieve incremental changes (deltas) since the last sync.

list_environments

List Environments

List all environments in the current space. Returns environment names, status, and metadata.

search_assets

Search Assets

Search and filter assets in a Contentful space. Supports filtering by mime type, file name, and other query parameters. Returns asset metadata, file URLs, and dimensions.

create_entry

Create Entry

Create a new entry for a given content type. Provide fields as a locale-keyed object. Optionally publish the entry immediately after creation.

get_entry

Get Entry

Retrieve a single entry by ID. Returns the full entry fields, metadata, and version information.

manage_tags

Manage Tags

List, create, update, or delete content tags in the current environment. Tags help organize and filter content.

search_entries

Search Entries

Search and filter entries in a Contentful space. Supports filtering by content type, field values, tags, creation/update dates, and full-text search. Returns paginated results with entry fields, metadata, and linked resources.

manage_release

Manage Release

Manage Release.v1 groups of entries and assets. Publish and unpublish return asynchronous action receipts; get with releaseActionId reads their status.

manage_content_type

Manage Content Type

Create, update, publish, unpublish, or delete a content type. When creating or updating, provide the full field definitions. Use the activate action to publish a content type so entries can be created from it.

get_asset

Get Asset

Retrieve a single asset by ID. Returns full asset metadata including file URL, dimensions, and locale-specific fields.

manage_entry_lifecycle

Manage Entry Lifecycle

Perform lifecycle actions on an entry: publish, unpublish, archive, unarchive, or delete. Fetches the current version automatically if not provided.

get_current_user

Get Current User

Read the user authenticated by a Content Management API PAT or OAuth token. Delivery and Preview API keys do not identify a CMA user.

list_spaces

List Spaces

List a page of spaces accessible to the Content Management API user. Use returned space IDs on subsequent tools.

download_asset

Download Asset

Download the processed original file for an exact asset ID and locale. Discover available locales with get_asset. Secure or embargoed files require a separately configured delivery workflow.

Connect Contentful to your AI client

Every client uses the same Magic MCP URL, and so does any other MCP client. Add it once and sign in with SSO.

  1. Enable Contentful in Metorial. In your Metorial portal, enable the Contentful MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
  2. Add a custom connector. Open Customize, then Connectors. Select Add, then Custom, then Web.
  3. Paste your Metorial MCP URL. Name it Metorial, paste your Magic MCP URL (<your-magic-mcp-url>) and continue.
  4. Sign in. Select Add and sign in to load Contentful tools.

Run Contentful through the Metorial gateway

One governed layer for every app your agents reach, not a separate connector per tool.

  • Give Contentful and every other app to your whole team through one MCP gateway, behind your SSO.
  • Scope which teams and agents can use Contentful tools with role-based access control, and trace every call.
  • Prefer to run it yourself? Metorial is open source and self-hostable.

More integrations teams use with Contentful

Notion

Create, read, update, and archive pages and databases in a Notion workspace. Manage blocks (paragraphs, lists, headings, embeds, etc.) within pages. Query databases with filters and sorts across rich property types including text, numbers, dates, selects, relations, and formulas. Search across pages and databases by title. Add and read comments on pages and blocks. Upload files to pages. Manage workspace users and retrieve user profiles.

Sharepoint

Manage SharePoint sites, document libraries, lists, and files. Create, read, update, and delete lists and list items with custom columns. Resolve site users to numeric Person/Group LookupId values. Upload, download, move, copy, and version files in document libraries. Search across sites, files, folders, lists, and list items using Microsoft Search. Manage permissions at site, list, and item levels with granular access control. Define and manage content types and site columns. Retrieve site properties and search for sites across Microsoft 365.

Confluence

Create, read, update, and delete pages, blog posts, comments, and attachments in Confluence spaces. Manage spaces, permissions, labels, and content restrictions. Search content using Confluence Query Language (CQL). Upload and download file attachments with versioning. Manage users, groups, and group memberships. Create and manage whiteboards, databases, folders, and templates. View and update inline tasks. Access audit logs.

Netlify

Manage web application sites, deploys, builds, build hooks, deployed files, metadata, and hosting on Netlify. Create, update, configure, list, and delete sites. Manage environment variables with per-context values and scopes. Access and manage form submissions, including spam filtering. Configure DNS zones and records. Inject JavaScript or HTML snippets into site pages. Create and manage split tests (A/B testing) for traffic routing between branches. Set up notification hooks for deploy and form submission events. Purge CDN cached content by site or cache tag.

Typeform

Create, retrieve, update, and delete online forms and surveys. Manage form responses, including filtering by date and deleting submissions. Configure webhooks to receive real-time notifications on form submissions and partial responses. Upload and manage images, create and apply visual themes, and organize forms across workspaces with team collaboration. Translate forms into multiple languages, retrieve form insights and analytics, and download files uploaded by respondents.

WordPress

Create, read, update, and delete WordPress posts and pages. Manage media library items, comments, categories, tags, site users, site metadata, editable site settings, content search, and WordPress.com site statistics. Supports WordPress.com hosted sites via OAuth and self-hosted WordPress sites via application passwords.

Technical notes for Contentful

Discover accessible spaces and authenticated CMA user details. Read entries, assets, content types, locales, and tags with the appropriate Management, Delivery, or Preview credential, including EU data residency. Create and update localized entries and assets, manage their lifecycle and content types, download an exact public asset locale, page incremental delivery syncs, schedule entry actions, and manage Release.v1 groups with asynchronous status receipts.

Frequently asked questions

Common questions about connecting Contentful to AI agents with Metorial.

  1. How many tools does the Contentful MCP server have?
    The Contentful MCP server exposes 20 tools, including Schedule Action, Create Asset, Update Entry. Each one is governed and traced through Metorial.
  2. Contentful exposes tools your agents call on demand; it does not publish event triggers yet. Everything still runs through one governed MCP URL.
  3. Any MCP client, including VS Code, Windsurf, Zed, OpenCode and Grok. Each one reaches the Contentful MCP server through the same Metorial URL.
  4. Use role-based access control to decide which teams, users, and agents can use Contentful and which of its tools they can call.
  5. Yes. Metorial is open source, so you can run the Contentful MCP server yourself or use the hosted gateway.

Connect Contentful to production AI agents

See how Metorial gives your team governed access to Contentful, with tracing and security controls built in.

Book a demoDeploy Contentful