{"id":29650174,"url":"https://github.com/contentful/contentful-mcp-server","last_synced_at":"2026-04-14T04:03:56.531Z","repository":{"id":305758223,"uuid":"1012116527","full_name":"contentful/contentful-mcp-server","owner":"contentful","description":"MCP (Model Context Protocol) server for the Contentful Management API","archived":false,"fork":false,"pushed_at":"2026-04-08T03:18:15.000Z","size":2044,"stargazers_count":50,"open_issues_count":42,"forks_count":20,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-08T18:04:50.140Z","etag":null,"topics":["content-management","contentful","mcp"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/contentful.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":"NOTICE","maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-07-01T20:52:56.000Z","updated_at":"2026-04-03T08:21:30.000Z","dependencies_parsed_at":"2025-07-21T22:23:43.220Z","dependency_job_id":"971d7f83-9648-45cd-a1f4-d55f6e3b4202","html_url":"https://github.com/contentful/contentful-mcp-server","commit_stats":null,"previous_names":["contentful/contentful-mcp-server"],"tags_count":50,"template":false,"template_full_name":null,"purl":"pkg:github/contentful/contentful-mcp-server","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/contentful%2Fcontentful-mcp-server","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/contentful%2Fcontentful-mcp-server/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/contentful%2Fcontentful-mcp-server/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/contentful%2Fcontentful-mcp-server/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/contentful","download_url":"https://codeload.github.com/contentful/contentful-mcp-server/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/contentful%2Fcontentful-mcp-server/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31781292,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-14T02:24:21.117Z","status":"ssl_error","status_checked_at":"2026-04-14T02:24:20.627Z","response_time":153,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["content-management","contentful","mcp"],"created_at":"2025-07-22T05:00:44.051Z","updated_at":"2026-04-14T04:03:56.525Z","avatar_url":"https://github.com/contentful.png","language":"TypeScript","funding_links":[],"categories":["📚 Projects (1974 total)","Content Management MCP Servers","Headless CMS"],"sub_categories":["MCP Servers"],"readme":"# Contentful MCP Server\n\nA [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) server that provides AI assistants with comprehensive tools to interact with [Contentful](https://www.contentful.com/) APIs.\n\n## 🚀 Example Use Cases\n\nThis MCP server provides a comprehensive set of tools for content management, allowing AI to help you create, edit, organize, and publish content directly within Contentful. Once configured, you can use natural language in your AI assistant of choice to manage and interact with your Contentful spaces, including:\n\n- **Content Creation**: \"Create a new blog post for our fall product launch\"\n- **Content Management**: \"Update all product entries to include the new pricing structure\"\n- **Asset Organization**: \"Upload and organize these marketing images by campaign\"\n- **Workflow Automation**: \"Create an AI action that translates content to Spanish\"\n- **Content Modeling**: \"Add a new field to the product content type for customer ratings\"\n\n## 📓 Table of Contents\n\n- [⚙️ Getting Started](#-getting-started)\n  - [Prerequisites](#prerequisites)\n  - [Installation](#installation)\n  - [Environment Variables](#environment-variables)\n  - [Configuration](#configuration)\n- [🛠️ Available Tools](#️-available-tools)\n- [🔍 Development](#-development)\n  - [Testing with MCP Inspector](#testing-with-mcp-inspector)\n- [📦 Releases](#-releases)\n- [🤝 Contributing and development](#-contributing)\n- [📚 Documentation](#-documentation)\n- [❓ Help \u0026 Support](#-help--support)\n- [📄 License and Notices](#-license-and-notices)\n- [🛡️ Code of Conduct](#️-code-of-conduct)\n\n## ⚙️ Getting started\n\n### Prerequisites\n\n- Node.js\n- npm\n- A Contentful account with a [Space ID](https://www.contentful.com/help/spaces/find-space-id/)\n- [Contentful Management API personal access token](https://www.contentful.com/help/token-management/personal-access-tokens/)\n\n### Installation\n\n#### One-Click install\n\n[![Install MCP Server](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/en/install-mcp?name=contentful-mcp\u0026config=eyJjb21tYW5kIjoibnB4IC15IEBjb250ZW50ZnVsL21jcC1zZXJ2ZXIiLCJlbnYiOnsiQ09OVEVOVEZVTF9NQU5BR0VNRU5UX0FDQ0VTU19UT0tFTiI6InlvdXItQ01BLXRva2VuIiwiU1BBQ0VfSUQiOiJ5b3VyLXNwYWNlLWlkIiwiRU5WSVJPTk1FTlRfSUQiOiJtYXN0ZXIiLCJDT05URU5URlVMX0hPU1QiOiJhcGkuY29udGVudGZ1bC5jb20ifX0%3D)\n\n_Note: This requires [Cursor](https://cursor.com/) to be installed. If the link doesn't work, try the manual installation below._\n\n**Claude Desktop:**\n\nDownload the .dxt configuration file [here](https://github.com/contentful/contentful-mcp-server/releases) from the latest release and import it into Claude Desktop to automatically configure the MCP server with your environment variables.\n\n**Codex:**\n\n```bash\ncodex mcp add contentful --env CONTENTFUL_MANAGEMENT_ACCESS_TOKEN=\"your-CMA-token\" --env SPACE_ID=\"your-space-id\" --env ENVIRONMENT_ID=\"master\" --env CONTENTFUL_HOST=\"api.contentful.com\" -- npx -y @contentful/mcp-server\n```\n\n#### Install from source\n\n```bash\ngit clone https://github.com/contentful/contentful-mcp-server.git\ncd contentful-mcp-server\nnpm install\nnpm run build\n```\n\n### Environment Variables\n\n| Environment Variable                 | Required | Default Value        | Description                                          |\n| ------------------------------------ | -------- | -------------------- | ---------------------------------------------------- |\n| `CONTENTFUL_MANAGEMENT_ACCESS_TOKEN` | ✅ Yes   | -                    | Your Contentful Management API personal access token |\n| `SPACE_ID`                           | ✅ Yes   | -                    | Your Contentful Space ID                             |\n| `ENVIRONMENT_ID`                     | ❌ No    | `master`             | Target environment within your space                 |\n| `CONTENTFUL_HOST`                    | ❌ No    | `api.contentful.com` | Contentful API host                                  |\n| `NODE_ENV`                           | ❌ No    | `production`         | Node Environment to run in                           |\n\n### Configuration\n\nRefer to the documentation for your AI tool of choice for how to configure MCP servers. For example, see the documentation for [Codex](https://developers.openai.com/codex/mcp), [Cursor](https://docs.cursor.com/context/mcp), [VS Code](https://code.visualstudio.com/docs/copilot/chat/mcp-servers), or [Claude Desktop](https://modelcontextprotocol.io/quickstart/user).\n\nBelow is a sample configuration:\n\n```json\n{\n  \"mcpServers\": {\n    \"contentful-mcp\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@contentful/mcp-server\"],\n      \"env\": {\n        \"CONTENTFUL_MANAGEMENT_ACCESS_TOKEN\": \"your-CMA-token\",\n        \"SPACE_ID\": \"your-space-id\",\n        \"ENVIRONMENT_ID\": \"master\",\n        \"CONTENTFUL_HOST\": \"api.contentful.com\"\n      }\n    }\n  }\n}\n```\n\n## 🛠️ Available Tools\n\n| Category                  | Tool Name                  | Description                                      |\n| ------------------------- | -------------------------- | ------------------------------------------------ |\n| **Context \u0026 Setup**       | `get_initial_context`      | Initialize connection and get usage instructions |\n| **Content Types**         | `list_content_types`       | List all content types                           |\n|                           | `get_content_type`         | Get detailed content type information            |\n|                           | `create_content_type`      | Create new content types                         |\n|                           | `update_content_type`      | Modify existing content types                    |\n|                           | `publish_content_type`     | Publish content type changes                     |\n|                           | `unpublish_content_type`   | Unpublish content types                          |\n|                           | `delete_content_type`      | Remove content types                             |\n| **Entries**               | `search_entries`           | Search and filter entries                        |\n|                           | `get_entry`                | Retrieve specific entries                        |\n|                           | `create_entry`             | Create new content entries                       |\n|                           | `update_entry`             | Modify existing entries                          |\n|                           | `publish_entry`            | Publish entries (single or bulk)                 |\n|                           | `unpublish_entry`          | Unpublish entries (single or bulk)               |\n|                           | `delete_entry`             | Remove entries                                   |\n| **Assets**                | `upload_asset`             | Upload new assets                                |\n|                           | `list_assets`              | List and browse assets                           |\n|                           | `get_asset`                | Retrieve specific assets                         |\n|                           | `update_asset`             | Modify asset metadata                            |\n|                           | `publish_asset`            | Publish assets (single or bulk)                  |\n|                           | `unpublish_asset`          | Unpublish assets (single or bulk)                |\n|                           | `delete_asset`             | Remove assets                                    |\n| **Spaces \u0026 Environments** | `list_spaces`              | List available spaces                            |\n|                           | `get_space`                | Get space details                                |\n|                           | `list_environments`        | List environments                                |\n|                           | `create_environment`       | Create new environments                          |\n|                           | `delete_environment`       | Remove environments                              |\n| **Locales**               | `list_locales`             | List all locales in your environment             |\n|                           | `get_locale`               | Retrieve specific locale information             |\n|                           | `create_locale`            | Create new locales for multi-language content    |\n|                           | `update_locale`            | Modify existing locale settings                  |\n|                           | `delete_locale`            | Remove locales from environment                  |\n| **Tags**                  | `list_tags`                | List all tags                                    |\n|                           | `create_tag`               | Create new tags                                  |\n| **AI Actions**            | `create_ai_action`         | Create custom AI-powered workflows               |\n|                           | `invoke_ai_action`         | Invoke an AI action with variables               |\n|                           | `get_ai_action_invocation` | Get AI action invocation details                 |\n|                           | `get_ai_action`            | Retrieve AI action details and configuration     |\n|                           | `list_ai_actions`          | List AI actions in a space                       |\n|                           | `update_ai_action`         | Update existing AI actions                       |\n|                           | `publish_ai_action`        | Publish AI actions for use                       |\n|                           | `unpublish_ai_action`      | Unpublish AI actions                             |\n|                           | `delete_ai_action`         | Remove AI actions                                |\n\n## 🤝 Contributing and Development\n\nWe welcome contributions! Please see our [Contributing Guide](CONTRIBUTING.md) for local development setup and contribution guidelines.\n\n## 📦 Releases\n\nThis project uses [Nx Release](https://nx.dev/features/manage-releases) for automated versioning and publishing. Releases are automatically generated based on [Conventional Commits](https://www.conventionalcommits.org/). See [Contributing Guide](CONTRIBUTING.md) for more information on release process.\n\nSee [github releases](https://github.com/contentful/contentful-mcp-server/releases) and [npm](https://www.npmjs.com/package/@contentful/mcp-server)\n\n## 📚 Documentation\n\n- [Model Context Protocol Documentation](https://modelcontextprotocol.io/)\n- [Contentful Management API Documentation](https://www.contentful.com/developers/docs/references/content-management-api/)\n\n## ❓ Help \u0026 Support\n\n- [Contentful support resources](https://www.contentful.com/help/getting-started/how-to-get-help/)\n- [Report bugs or request features](https://github.com/contentful/contentful-mcp-server/issues)\n- [Contentful Community Discord](https://www.contentful.com/discord/)\n\n## 📄 License and Notices\n\nThis project is licensed under the MIT License. See [LICENSE](./LICENSE) for details.\n\nIt also includes open-source components licensed under MIT, BSD-2-Clause, and Apache-2.0. For details, see the [NOTICE](./NOTICE) file.\n\nThis project includes an automated license management system that keeps track of all dependencies and their licenses. See the [AUTOMATION-FOR-LICENSES](./AUTOMATION-FOR-LICENSES.md) file for more information.\n\n## 🛡️ Code of Conduct\n\nWe want 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.\n\n[Read our full Code of Conduct](https://www.contentful.com/developers/code-of-conduct/).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcontentful%2Fcontentful-mcp-server","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcontentful%2Fcontentful-mcp-server","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcontentful%2Fcontentful-mcp-server/lists"}