Strapi Content
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.
Ask AI about Strapi Content
Powered by Claude · Grounded in docs
I know everything about Strapi Content. Ask me about installation, configuration, usage, or troubleshooting.
0/500
Reviews
Documentation
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)
