The Contentstack MCP Server integrates with Contentstack's Content Management API, enabling AI assistants like Claude to interact with a Contentstack CMS via the MCP protocol. Its capabilities include:
Content Type Management: List, create, retrieve, update, and delete content types with detailed schemas, options, field rules, and taxonomies
Entry Management: List, create, retrieve, update, delete, publish, and unpublish entries with filtering, sorting, and pagination
Global Field Management: List, create, update, and retrieve global fields for reuse across content types
Asset Management: List and manage assets programmatically
Workflow Automation: Facilitate guided content creation workflows and provide content analysis
Branch Support: Manage content across different branches
Integration with AI Assistants: Connect with tools like Claude for Desktop and Cursor
Extensibility: Configure for custom use cases and integrations
Uses Biome.js for linting and formatting, providing code style consistency and early issue detection in the development workflow.
Integrates with Contentstack's Content Management API, enabling interaction with content types, entries, assets, global fields, and content workflows. Supports creating, updating, deleting and publishing content in the Contentstack CMS.
Contentstack MCP Server
This Model Context Protocol (MCP) server integrates with Contentstack's Content Management API, enabling AI assistants like Claude to interact with your Contentstack CMS through a standardized protocol.
Note: This is an early version of Contentstack MCP Server. See the Roadmap for upcoming improvements and planned features.
Table of Contents
Features
Available Resources
content-types
: List all content types (URI:contentstack://content-types
)content-type
: Get content type by UID (URI:contentstack://content-type/{uid}
)entries
: Get entries by content type (URI:contentstack://entries/{content_type_uid}
)entry
: Get specific entry (URI:contentstack://entry/{content_type_uid}/{entry_uid}
)assets
: List all assets (URI:contentstack://assets
)
Content Type Management
Create, update, and delete content types
Define schemas, options, field rules, and taxonomies
Manage global fields
Entry Management
Create, update, and delete entries
Publish and unpublish entries across environments
Query entries with filtering, pagination, and sorting options
Global Field Management
Create and update global fields for reuse across content types
Retrieve global fields with pagination options
Content Workflows
Guided content creation workflows
Content analysis and insights
Migration planning assistance
Installation
Prerequisites
Node.js (v16.0.0 or higher)
A Contentstack account
API credentials (API Key and Management Token)
NPM Installation
The easiest way to use this MCP server is via NPM:
Manual Installation
Clone the repository:
git clone https://github.com/darekrossman/contentstack-mcp.git cd contentstack-mcpInstall dependencies:
npm installSet up environment variables:
cp .env.example .envEdit the
.env
file with your Contentstack credentials:CONTENTSTACK_API_KEY=your_api_key_here CONTENTSTACK_MANAGEMENT_TOKEN=your_management_token_here # Optional: Specify branch if using branches CONTENTSTACK_BRANCH=your_branch_nameBuild and start the server:
npm run build npm start
Installation via Smithery CLI
You can also install this MCP server using the Smithery CLI:
See the Smithery CLI documentation for more details and advanced usage.
Development
Setup for Development
For development, you can use:
This starts the server using ts-node
for a faster development cycle.
Code Quality
This project uses Biome.js for linting and formatting. It provides a consistent code style and helps catch potential issues early.
Available Commands
Lint Code:
npm run lintLint and Fix:
npm run lint:fixFormat Code:
npm run formatFormat and Fix:
npm run format:fix
Configuration
Authentication
This server requires authentication with Contentstack's API:
Management Token (Required):
Stack-level token with predefined permissions
Set via
CONTENTSTACK_MANAGEMENT_TOKEN
environment variableGenerate from Contentstack dashboard: Settings > Tokens > Management Tokens
API Key (Required):
Stack API key for authentication
Set via
CONTENTSTACK_API_KEY
environment variable
Branch Support
If your Contentstack account uses branches, you can specify a branch:
Integration with AI Assistants
Claude for Desktop
To use this server with Claude for Desktop:
Edit your Claude for Desktop configuration file:
Mac:
~/Library/Application Support/Claude/claude_desktop_config.json
Windows:
%APPDATA%\Claude\claude_desktop_config.json
Add this server to the
mcpServers
section:{ "mcpServers": { "contentstack": { "command": "npx", "args": ["-y", "@drossman/contentstack-mcp"], "env": { "CONTENTSTACK_API_KEY": "your_api_key_here", "CONTENTSTACK_MANAGEMENT_TOKEN": "your_management_token_here" } } } }Restart Claude for Desktop
Cursor
To use this server with Cursor, add the Contentstack MCP server configuration:
Install with Smithery
You can also install this MCP server using the Smithery CLI using your client of choice:
Available clients include:
claude
cline
windsurf
roocode
witsy
enconvo
cursor
vscode
vscode-insiders
boltai
amazon-bedrock
amazonq
See the Smithery CLI documentation for more details and advanced usage.
Roadmap
Enhanced AI Contextual Understanding: Improve context provisioning for complex queries
Advanced Querying & Filtering: Support filtering by multiple criteria and custom fields
Workflow & Publishing Automation: Enable AI-driven content workflow actions
Asset Management Enhancements: Add direct asset manipulation capabilities
Bulk Operations Support: Implement batch operations for entries and assets
Improved Error Handling & AI Feedback: Refine error messages for AI consumption
User-Specific Context & Permissions: Tailor actions based on user permissions
Extensibility for Custom Tools: Create an extension framework
Real-time Event Handling: Add webhook support for reactive AI behaviors
Comprehensive Documentation: Develop detailed guides for AI interaction
Shoutout
Special thanks to Ivo Toby. This project and its author are heavily inspired by his work in this space.
License
MIT
Disclaimer: This project is not affiliated with, endorsed by, or supported by Contentstack. It is an independent open-source project designed to work with the Contentstack API.
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Tools
Enable AI assistants to interact seamlessly with your Contentstack CMS by accessing and managing content types, entries, assets, and global fields through a standardized protocol. Perform CRUD operations and content publishing directly via AI-driven commands to streamline content management workflows. Enhance your content operations with AI-powered automation and real-time content manipulation capabilities.
- Table of Contents
- Features
- Installation
- Development
- Configuration
- Integration with AI Assistants
- Roadmap
- Shoutout
- License
Related Resources
Related MCP Servers
- AsecurityAlicenseAqualityUpdate, create, delete content, content-models and assets in your Contentful SpaceLast updated -7661MIT License
- -securityAlicense-qualityEnables management of Payload CMS projects through natural language commands, allowing developers to create, configure, and deploy content models with conversational AI.Last updated -2090MIT License
- -securityAlicense-qualityEnables AI assistants to interact with WordPress sites through the REST API. Supports multiple WordPress sites with secure authentication, enabling content management, post operations, and site configuration through natural language.Last updated -40MIT License
- AsecurityAlicenseAqualityEnables AI assistants to interact with WordPress sites through REST APIs, allowing programmatic management of posts, users, comments, categories, and tags with secure authentication.Last updated -2946MIT License