Strapi MCP

Name: Strapi MCP
Author: l33tdawg

@l33tdawg

Repository

About Strapi MCP

An MCP server for your Strapi CMS

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "strapi-mcp": {
      "command": "node",
      "args": [
        "--env-file=.env",
        "build/index.js"
      ]
    }
  }
}

Tools

List all available content types in Strapi

Get entries for a specific content type with optional filtering, pagination, sorting, and population of relations

Get a specific entry by ID

Create a new entry for a content type

Update an existing entry

Delete an entry

Upload a media file to Strapi (max ~750KB file due to base64 context limits)

Upload a media file from local file path (max 10MB, avoids context overflow)

Get the schema (fields, types, relations) for a specific content type.

Connect related entries to an entry's relation field.

Disconnect related entries from an entry's relation field.

Create a new content type using the Content-Type Builder API (Requires Admin privileges).

Publish a specific entry.

Unpublish a specific entry.

List all available components in Strapi.

Get the schema for a specific component.

Create a new component.

Update an existing component.

Overview

What is Strapi MCP?

Strapi MCP is a Model Context Protocol server that integrates with any Strapi CMS instance. It provides AI assistants with access to Strapi content types and entries, enabling automated content management through MCP resources and tools.

How to use Strapi MCP?

Install from npm (npm install strapi-mcp) or from source. Configure environment variables (STRAPI_URL, STRAPI_ADMIN_EMAIL, STRAPI_ADMIN_PASSWORD, and optional STRAPI_API_TOKEN and STRAPI_DEV_MODE). Run via Cursor MCP configuration (in ~/.cursor/mcp.json) or Claude Desktop config, or directly with node --env-file=.env build/index.js. Use built-in tools to manage Strapi content.

Key features of Strapi MCP

List and read content types as resources
Create, read, update, and delete entries
Upload media files via base64 or local file path
Connect and disconnect relations between entries
Manage components (list, create, update, get schema)
Publish and unpublish entries
Robust error handling and configuration validation

Use cases of Strapi MCP

Let AI assistants read and modify Strapi content types and entries
Automate content creation, updates, and publishing workflows
Manage component schemas and relationships programmatically

FAQ from Strapi MCP

What authentication methods are supported?

You can use admin email/password (recommended for full schema access) or an API token as a fallback. The server prefers admin credentials and validates configuration to reject common placeholders.

What environment variables are required?

STRAPI_URL (default http://localhost:1337), STRAPI_ADMIN_EMAIL, and STRAPI_ADMIN_PASSWORD are recommended. STRAPI_API_TOKEN is optional. Set STRAPI_DEV_MODE=true to enable development mode features.

What are the file size limits for media uploads?

The upload_media tool has a ~1MB base64 size limit (~750KB file) to prevent context overflow. upload_media_from_path supports files up to 10MB from local file paths.

How can I filter, paginate, and sort entries?

The get_entries tool supports filters (e.g., {"title": {"$contains": "hello"}}), pagination (page, pageSize), sort (e.g., ["title:asc"]), and populate for relations.

What is the purpose of STRAPI_DEV_MODE?

Setting STRAPI_DEV_MODE to true enables development mode features in Strapi, allowing the server to access additional functionality during local development. It defaults to false.