Contentful Management API MCP Server

Contentful MCP Server

The Contentful MCP (Model Context Protocol) server allows Claude AI to interact directly with your Contentful content management system. This integration enables you to create, update, and manage content in your Contentful spaces through natural language conversations with Claude.

Installation

You can install the Contentful MCP server using npm:

npm install @contentful/mcp-server

Configuration

The server requires authentication with Contentful. You can configure it using environment variables or by passing configuration options directly.

Authentication Methods

The server supports three authentication methods:

1. Personal Access Token (PAT): Use your Contentful personal access token
2. OAuth Token: Use an OAuth token for authentication
3. App Identity: Use Contentful App Identity for authentication

Environment Variables

Set up the following environment variables:

• CONTENTFUL_SPACE_ID: Your Contentful space ID
• CONTENTFUL_ENVIRONMENT_ID: Your Contentful environment ID (defaults to "master")
• CONTENTFUL_ACCESS_TOKEN: Your Contentful personal access token
• CONTENTFUL_OAUTH_TOKEN: Your Contentful OAuth token (alternative to PAT)
• CONTENTFUL_APP_ID: Your Contentful App ID (for App Identity authentication)
• CONTENTFUL_APP_KEY: Your Contentful App private key (for App Identity authentication)
• MCP_PORT: Port for the HTTP/SSE transport (defaults to 8080)
• MCP_TRANSPORT: Transport mode, either "stdio" (default) or "http"

Running the Server

You can run the server using the provided CLI:

npx mcp-server

Or integrate it into your Node.js application:

import { startServer } from '@contentful/mcp-server';

startServer({
  spaceId: 'your-space-id',
  environmentId: 'master',
  accessToken: 'your-access-token',
  transport: 'stdio' // or 'http'
});

Transport Modes

The server supports two transport modes:

1. stdio: Standard input/output mode (default) - ideal for direct integration with Claude
2. http: HTTP/SSE transport mode - useful for network-based integrations

Using with Claude

To use the Contentful MCP with Claude, add the following configuration to your Claude settings:

{
  "mcpServers": {
    "contentful": {
      "command": "npx",
      "args": ["mcp-server"]
    }
  }
}

If you're using environment variables for configuration, make sure they're available in the environment where Claude is running.

Docker Support

The server can also be run in a Docker container:

docker run -e CONTENTFUL_SPACE_ID=your-space-id -e CONTENTFUL_ACCESS_TOKEN=your-token contentful/mcp-server

Troubleshooting

If you encounter issues:

1. Verify your authentication credentials
2. Check that your space ID and environment ID are correct
3. Ensure you have the necessary permissions in Contentful
4. Check the server logs for detailed error messages

For more detailed information, visit the GitHub repository.