strapi-mcp

Strapi MCP Server

AI-powered content management for Strapi CMS via Model Context Protocol.

  

Features

Connect any MCP-compatible AI assistant (Claude, Cursor, etc.) to your Strapi CMS. Manage content, media, locales, and more through natural language.

20 Tools across 8 categories

| Category | Tools | Description | |----------|-------|-------------| | Schema (3) | list_content_types, get_content_type_schema, get_components | Discover and inspect content models | | Content (5) | list_entries, get_entry, create_entry, update_entry, delete_entry | Full CRUD for any content type | | Media (3) | upload_media, list_media, delete_media | Upload, browse, and manage media library | | Publish (3) | publish_entry, unpublish_entry, discard_draft | Control publication lifecycle | | i18n (2) | list_locales, get_localized_entry | Internationalization support | | Search (2) | search_entries, count_entries | Full-text search and counting | | Bulk (1) | bulk_action | Batch create, update, or delete | | System (1) | get_strapi_info | Server info and version detection |

Additional MCP capabilities

• 3 Prompts: manage_content, content_migration, setup_guide -- guided workflows for common tasks
• 1 Resource: strapi://help -- comprehensive usage guide with examples

Quick Start

1. Install the server:

   pip install strapi-mcp

1. Configure your Strapi connection:

   export STRAPI_BASE_URL="http://localhost:1337"
   export STRAPI_API_TOKEN="your-strapi-api-token"

1. Connect from your MCP client (see Client Configuration below).

Installation

Using pip

pip install strapi-mcp

Using uvx (no install required)

uvx strapi-mcp

From source

git clone https://github.com/alexzimmermann/strapi-mcp.git
cd strapi-mcp
pip install -e .

Configuration

All settings are configured via environment variables with the STRAPI_ prefix:

| Variable | Default | Description | |----------|---------|-------------| | STRAPI_BASE_URL | http://localhost:1337 | URL of your Strapi instance | | STRAPI_API_TOKEN | (empty) | API token for authentication. Create in Strapi Admin > Settings > API Tokens. | | STRAPI_API_VERSION | auto | Strapi version: auto, v4, or v5 | | STRAPI_TIMEOUT | 30 | HTTP request timeout in seconds | | STRAPI_MAX_PAGE_SIZE | 100 | Maximum entries per page (1-100) |

You can also place these in a .env file in your working directory.

Creating a Strapi API Token

1. Open your Strapi Admin panel (e.g., http://localhost:1337/admin)
2. Navigate to Settings > API Tokens
3. Click Create new API Token
4. Set Token type to Full Access (or customize permissions)
5. Copy the generated token and set it as STRAPI_API_TOKEN

Client Configuration

Claude Desktop

Add to your Claude Desktop config file (claude_desktop_config.json):

{
  "mcpServers": {
    "strapi": {
      "command": "uvx",
      "args": ["strapi-mcp"],
      "env": {
        "STRAPI_BASE_URL": "http://localhost:1337",
        "STRAPI_API_TOKEN": "your-strapi-api-token"
      }
    }
  }
}

Cursor

Add to your Cursor MCP config:

{
  "mcpServers": {
    "strapi": {
      "command": "uvx",
      "args": ["strapi-mcp"],
      "env": {
        "STRAPI_BASE_URL": "http://localhost:1337",
        "STRAPI_API_TOKEN": "your-strapi-api-token"
      }
    }
  }
}

Smithery

This server is available on Smithery. Install directly from the Smithery registry or configure manually using the smithery.yaml included in this repository.

Available Tools

| Tool | Description | |------|-------------| | list_content_types | List all available content types in the Strapi instance | | get_content_type_schema | Get the full field schema for a specific content type | | get_components | List all reusable components and their schemas | | list_entries | List entries with filtering, sorting, pagination, and population | | get_entry | Get a single entry by ID (or documentId in v5) | | create_entry | Create a new content entry with field data | | update_entry | Update an existing entry by ID | | delete_entry | Delete an entry by ID | | upload_media | Upload a file to the media library (URL or base64) | | list_media | Browse the media library with pagination | | delete_media | Delete a file from the media library | | publish_entry | Publish a draft entry to make it publicly available | | unpublish_entry | Revert a published entry to draft status | | discard_draft | Discard unsaved draft changes (Strapi v5 only) | | list_locales | List all configured locales for i18n | | get_localized_entry | Get an entry in a specific locale | | search_entries | Full-text search across entries of a content type | | count_entries | Count entries matching optional filter criteria | | bulk_action | Perform bulk create, update, or delete operations | | get_strapi_info | Get Strapi server info, version, and connection status |

Strapi Version Support

This server supports both Strapi v4 and Strapi v5 with automatic version detection.

Auto-detection

When STRAPI_API_VERSION is set to auto (the default), the server detects your Strapi version at startup by:

1. Fetching a content type entry and inspecting its response format
2. Checking the admin information endpoint for a version string
3. Defaulting to v5 if detection is inconclusive

Key differences handled automatically

| Feature | Strapi v4 | Strapi v5 | |---------|-----------|-----------| | Entry format | Nested data.attributes | Flat with documentId | | Entry identifier | Numeric id | String documentId | | Publication status | publicationState=live\|preview | status=published\|draft | | Draft discard | Not available | discard_draft tool |

You can force a specific version by setting STRAPI_API_VERSION=v4 or STRAPI_API_VERSION=v5.

Development

Setup

git clone https://github.com/alexzimmermann/strapi-mcp.git
cd strapi-mcp
python -m venv .venv
source .venv/bin/activate  # or .venv\Scripts\activate on Windows
pip install -e ".[dev]"

Running tests

pytest

Running with coverage

pytest --cov=strapi_mcp --cov-report=term-missing

Code style

ruff check .
ruff format .

License

MIT License. See LICENSE for details.