Strapi Content MCP

A Strapi v5 plugin that exposes your content via the Model Context Protocol (MCP), enabling AI assistants like Claude to interact directly with your Strapi content.

Features

Direct Strapi Integration - Uses Strapi's internal Document Service API with full sanitization
HTTP/SSE Transport - Standard HTTP endpoint for MCP communication
8 MCP Tools - Full CRUD operations plus media upload
Security First - Input/output sanitization, route-level auth via Strapi policies
Strapi v5 Compatible - Built for the latest Strapi version

Installation

# Using npm
npm install strapi-content-mcp

# Using yarn
yarn add strapi-content-mcp

Configuration

Add to your Strapi config/plugins.ts (or config/plugins.js):

export default {
  'strapi-content-mcp': {
    enabled: true,
    config: {
      // Optional: Set log level (default: 'info')
      logLevel: 'info', // 'error' | 'warn' | 'info' | 'debug' | 'trace'
    },
  },
};

Then rebuild and start Strapi:

yarn build
yarn develop

Connecting Claude Desktop

Edit your Claude Desktop configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "strapi-content": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "http://localhost:1337/api/strapi-content-mcp/mcp"
      ]
    }
  }
}

Restart Claude Desktop and start chatting with your Strapi content!

Available Tools

Tool	Description
`list_content_types`	List all content types with their schemas
`list_components`	List components with pagination
`find_many`	Query documents with filters, sort, pagination
`find_one`	Get single document by documentId
`create`	Create new document
`update`	Update existing document
`delete`	Delete document
`upload_media`	Upload media from URL

Example Usage

Once connected, ask Claude:

"List all content types in Strapi"
"Find all published articles"
"Create a new blog post titled 'Hello World'"
"Update article abc123 to change the title"
"Upload this image to Strapi"

Tool Examples

Finding Documents

find_many with uid: "api::article.article"
- filters: { publishedAt: { $notNull: true } }
- sort: "createdAt:desc"
- pagination: { page: 1, pageSize: 10 }
- populate: ["author", "category"]

Creating Documents

create with uid: "api::article.article"
- data: { title: "My Article", content: "Hello world" }
- status: "published"

Security

This plugin includes several security measures:

Output Sanitization: All data returned is sanitized to remove private fields
Input Sanitization: All incoming data is sanitized before database writes
Fail-Closed: If sanitization fails, operations are rejected (no unsanitized data exposed)

For production use, consider adding authentication:

// config/plugins.ts
export default {
  'strapi-content-mcp': {
    enabled: true,
    config: {
      // Add route middleware for authentication
    },
  },
};

Requirements

Strapi v5.x
Node.js 18+ (including Node.js 22, 24+)

API Endpoint

The MCP endpoint is available at:

POST/GET/DELETE http://localhost:1337/api/strapi-content-mcp/mcp

Troubleshooting

Memory Issues

If you encounter heap memory errors during Strapi build:

NODE_OPTIONS='--max-old-space-size=8192' yarn build
NODE_OPTIONS='--max-old-space-size=8192' yarn develop

Connection Issues

Ensure Strapi is running on the expected port
Check Claude Desktop config file syntax (valid JSON)
Restart Claude Desktop after config changes
Check Strapi logs for MCP-related errors

Contributing

Contributions welcome! Please:

Fork the repository
Create a feature branch
Make your changes
Submit a pull request

License

MIT - see LICENSE for details.

Author

Paul Bratslavsky (@PaulBratslavsky)