ivo-toby/contentful-mcp

Notice
This is a community driven server! Contentful has released an official server which you can find here
An MCP server implementation that integrates with Contentful's Content Management API, providing comprehensive content management capabilities.
- Please note \*; if you are not interested in the code, and just want to use this MCP in
Claude Desktop (or any other tool that is able to use MCP servers) you don't have to
clone this repo, you can just set it up in Claude desktop, refer to the section
"Usage with Claude Desktop" for instructions on how to install it.
Features
- **Content Management**: Full CRUD operations for entries and assets
- **Comment Management**: Create, retrieve, and manage comments on entries with support for both plain-text and rich-text formats, including threaded conversations
- **Space Management**: Create, update, and manage spaces and environments
- **Content Types**: Manage content type definitions
- **Localization**: Support for multiple locales
- **Publishing**: Control content publishing workflow
- **Bulk Operations**: Execute bulk publishing, unpublishing, and validation across multiple entries and assets
- **Smart Pagination**: List operations return maximum 3 items per request to prevent context window overflow, with built-in pagination support
Pagination
To prevent context window overflow in LLMs, list operations (like search_entries and list_assets) are limited to 3 items per request. Each response includes:
- Total number of available items
- Current page of items (max 3)
- Number of remaining items
- Skip value for the next page
- Message prompting the LLM to offer retrieving more items
This pagination system allows the LLM to efficiently handle large datasets while maintaining context window limits.
Bulk Operations
The bulk operations feature provides efficient management of multiple content items simultaneously:
- **Asynchronous Processing**: Operations run asynchronously and provide status updates
- **Efficient Content Management**: Process multiple entries or assets in a single API call
- **Status Tracking**: Monitor progress with success and failure counts
- **Resource Optimization**: Reduce API calls and improve performance for batch operations
These bulk operation tools are ideal for content migrations, mass updates, or batch publishing workflows.
Tools
Entry Management
- **search_entries**: Search for entries using query parameters
- **create_entry**: Create new entries
- **get_entry**: Retrieve existing entries
- **update_entry**: Update entry fields
- **delete_entry**: Remove entries
- **publish_entry**: Publish entries
- **unpublish_entry**: Unpublish entries
Comment Management
- **get_comments**: Retrieve comments for an entry with filtering by status (active, resolved, all)
- **create_comment**: Create new comments on entries with support for both plain-text and rich-text formats. Supports threaded conversations by providing a parent comment ID to reply to existing comments
- **get_single_comment**: Retrieve a specific comment by its ID for an entry
- **delete_comment**: Delete a specific comment from an entry
- **update_comment**: Update existing comments with new body content or status changes
Threaded Comments
Comments support threading functionality to enable structured conversations and work around the 512-character limit:
- **Reply to Comments**: Use the parent parameter in create_comment to reply to an existing comment
- **Threaded Conversations**: Build conversation trees by replying to specific comments
- **Extended Discussions**: Work around the 512-character limit by creating threaded replies to continue longer messages
- **Conversation Context**: Maintain context in discussions by organizing related comments in threads
Example usage: