Contentful MCP Server

The Contentful MCP Server is an AI assistant tool that provides full - fledged interaction with the Contentful API, supporting operations such as content creation, management, asset organization, and automated workflows.

Developer tools #Content management #AI assistant #Automation tool #API integration .TypeScript

rating : 2.5 points

downloads : 0

update time : 2025-09-03

Open Site

What is the Contentful MCP Server?

The Contentful MCP Server is a bridge connecting AI assistants and the Contentful content management platform. It allows you to use natural language instructions to create, edit, publish, and manage website content, digital assets, and workflows without manually operating the Contentful backend interface.

How to use the Contentful MCP Server?

Simply configure the server in your AI assistant (such as Cursor, Claude Desktop, or VS Code Copilot), and then you can tell the AI the content management tasks you want to complete in everyday language, such as 'Create a blog post about the new product launch' or 'Update the price information of all products'.

Applicable scenarios

Suitable for scenarios where content creators, marketers, product managers, and developers need to frequently update website content, manage digital assets, and automate content workflows. Particularly applicable to multi - language content management, large - scale content updates, and team - collaborative content creation.

Main Features

Content Management

Create, edit, publish, and delete content entries, supporting search and filtering functions

Asset Management

Upload, organize, and manage digital assets such as images and documents, supporting metadata editing

Content Modeling

Create and modify content type structures, define fields and validation rules

AI Workflow

Create and call custom AI actions to implement automated content processing and workflows

Multi - Language Support

Manage multi - language content, supporting localization settings and translation workflows

Bulk Operations

Support batch publishing, unpublishing, and deleting content to improve operation efficiency

Advantages

Natural language interaction: Complex content management tasks can be completed using everyday language

Improve efficiency: Batch operations and automation reduce repetitive manual work

Lower technical threshold: Non - technical personnel can easily manage professional content platforms

Flexible integration: Supports multiple AI assistants and development environments

Real - time collaboration: Teams can collaborate to manage content through AI assistants simultaneously

Limitations

Requires API access permission: You need to configure the Contentful management API token

Network dependency: A stable network connection is required to access the Contentful service

Learning curve: You need to be familiar with the basic concepts and terms of Contentful

Function limitations: Some advanced functions may still need to be completed through the Web interface

How to Use

Get access credentials

Obtain the Space ID and management API access token from the Contentful backend

Install the server

Set up the MCP server through one - click installation or manual installation

Configure the AI assistant

Add the MCP server configuration in your AI assistant settings

Start using

Send content management instructions to the AI assistant in natural language

Usage Examples

Blog content creation

Quickly create and publish blog posts, including formatting and image insertion

Product information update

Batch update product information, such as price, description, or inventory status

Multi - language content management

Create and manage multi - language versions of content

Marketing material organization

Upload and organize image and document resources required for marketing campaigns

Frequently Asked Questions

Do I need programming knowledge to use this server?

Is this server secure? Will it leak my Contentful data?

Which AI assistants are supported?

If an operation goes wrong, will it damage my Contentful data?

How to handle the management of a large amount of content?

Related Resources

Contentful Official Documentation

Complete guide to using the Contentful platform and API reference

MCP Protocol Specification

Official technical specification and implementation guide for the Model Context Protocol

GitHub Code Repository

Source code, issue feedback, and contribution guide for the server

Contentful Community Discord

Join the Contentful developer community for help and communication

Installation and Configuration Video Tutorial

Step - by - step video installation and configuration guide

🚀 Contentful MCP Server

A Model Context Protocol (MCP) server that equips AI assistants with comprehensive tools to interact with Contentful APIs.

🚀 Quick Start

This MCP server offers a comprehensive suite of content management tools, enabling AI to directly create, edit, organize, and publish content within Contentful. Once configured, you can use natural language in your preferred AI assistant to manage and interact with your Contentful spaces. Here are some examples:

Content Creation: "Create a new blog post for our fall product launch"
Content Management: "Update all product entries to include the new pricing structure"
Asset Organization: "Upload and organize these marketing images by campaign"
Workflow Automation: "Create an AI action that translates content to Spanish"
Content Modeling: "Add a new field to the product content type for customer ratings"

📋 Table of Contents

⚙️ Getting Started
- Prerequisites
- Installation
- Environment Variables
- Configuration
🛠️ Available Tools
🔍 Development
- Testing with MCP Inspector
- Linting
📦 Releases
🤝 Contributing
- Development Setup
📚 Documentation
❓ Help & Support
📄 License and Notices
🛡️ Code of Conduct

⚙️ Getting Started

Prerequisites

Node.js
npm
A Contentful account with a Space ID
Contentful Management API personal access token

Installation

One-Click install

⚠️ Important Note

This requires Cursor to be installed. If the link doesn't work, try the manual installation below.

Claude Desktop:

Download the .dxt configuration file here from the latest release and import it into Claude Desktop to automatically configure the MCP server with your environment variables.

Install from source

git clone https://github.com/contentful/contentful-mcp-server.git
cd contentful-mcp-server
npm install
npm run build

Environment Variables

Property	Details
`CONTENTFUL_MANAGEMENT_ACCESS_TOKEN`	✅ Yes, Your Contentful Management API personal access token
`SPACE_ID`	✅ Yes, Your Contentful Space ID
`ENVIRONMENT_ID`	❌ No, Default: `master`, Target environment within your space
`CONTENTFUL_HOST`	❌ No, Default: `api.contentful.com`, Contentful API host
`NODE_ENV`	❌ No, Default: `production`, Node Environment to run in

Configuration

Refer to the documentation for your AI tool of choice for how to configure MCP servers. For example, see the documentation for Cursor, VS Code, or Claude Desktop.

Below is a sample configuration:

{
  "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"
      }
    }
  }
}

🛠️ Available Tools

Category	Tool Name	Description
Context & Setup	`get_initial_context`	Initialize connection and get usage instructions
Content Types	`list_content_types`	List all content types
	`get_content_type`	Get detailed content type information
	`create_content_type`	Create new content types
	`update_content_type`	Modify existing content types
	`publish_content_type`	Publish content type changes
	`unpublish_content_type`	Unpublish content types
	`delete_content_type`	Remove content types
Entries	`search_entries`	Search and filter entries
	`get_entry`	Retrieve specific entries
	`create_entry`	Create new content entries
	`update_entry`	Modify existing entries
	`publish_entry`	Publish entries (single or bulk)
	`unpublish_entry`	Unpublish entries (single or bulk)
	`delete_entry`	Remove entries
Assets	`upload_asset`	Upload new assets
	`list_assets`	List and browse assets
	`get_asset`	Retrieve specific assets
	`update_asset`	Modify asset metadata
	`publish_asset`	Publish assets (single or bulk)
	`unpublish_asset`	Unpublish assets (single or bulk)
	`delete_asset`	Remove assets
Spaces & Environments	`list_spaces`	List available spaces
	`get_space`	Get space details
	`list_environments`	List environments
	`create_environment`	Create new environments
	`delete_environment`	Remove environments
Locales	`list_locales`	List all locales in your environment
	`get_locale`	Retrieve specific locale information
	`create_locale`	Create new locales for multi-language content
	`update_locale`	Modify existing locale settings
	`delete_locale`	Remove locales from environment
Tags	`list_tags`	List all tags
	`create_tag`	Create new tags
AI Actions	`create_ai_action`	Create custom AI-powered workflows
	`invoke_ai_action`	Invoke an AI action with variables
	`get_ai_action_invocation`	Get AI action invocation details
	`get_ai_action`	Retrieve AI action details and configuration
	`list_ai_actions`	List AI actions in a space
	`update_ai_action`	Update existing AI actions
	`publish_ai_action`	Publish AI actions for use
	`unpublish_ai_action`	Unpublish AI actions
	`delete_ai_action`	Remove AI actions

🤝 Contributing

We welcome contributions! Please see our Contributing Guide for local development setup and contribution guidelines.

📦 Releases

This project uses Nx Release for automated versioning and publishing. Releases are automatically generated based on Conventional Commits. See Contributing Guide for more information on the release process.

📚 Documentation

❓ Help & Support

📄 License and Notices

This project is licensed under the MIT License. See LICENSE for details.

It also includes open-source components licensed under MIT, BSD-2-Clause, and Apache-2.0. For details, see the NOTICE file.

This project includes an automated license management system that keeps track of all dependencies and their licenses. See the AUTOMATION-FOR-LICENSES file for more information.

🛡️ Code of Conduct

We aim to provide a safe, inclusive, welcoming, and harassment-free space and experience for all participants, regardless of gender identity and expression, sexual orientation, disability, physical appearance, socioeconomic status, body size, ethnicity, nationality, level of experience, age, religion (or lack thereof), or other identity markers.

Read our full Code of Conduct.