Strapi MCP Server

A Model Context Protocol (MCP) server that connects AI assistants to your Strapi CMS. Enables AI to browse, create, edit, publish, and manage content through natural conversation.

Features

• Full CRUD — Create, read, update, delete content entries
• Schema introspection — AI discovers your content types, fields, and relations automatically
• Publish workflow — Publish and unpublish entries directly
• Media management — Browse, upload, and update media files (alt text, captions)
• i18n support — Work with multiple locales
• Secure auth — Login with Strapi admin credentials, role-based permissions
• Single & Collection types — Handles both seamlessly
• Zero config on CMS side — Uses Strapi's built-in admin API, no plugins required

Tools

Tool	Description
login	Authenticate with Strapi admin credentials
get_session	Check current user and role
list_content_types	Discover all content types and their structure
describe_content_type	Get detailed field definitions for a content type
list_entries	Browse entries with pagination
get_entry	Fetch a single entry with all fields
create_entry	Create new content
update_entry	Update existing content
delete_entry	Delete content
publish_entry	Make content live on the website
unpublish_entry	Revert to draft
list_media	Browse Media Library
upload_media	Upload files to Media Library
update_media	Update file metadata (alt text, caption, name)

Quick Start

Install

npm install -g github:devels-ai/strapi-mcp-server

Configure

Add to your AI client's MCP configuration:

Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "strapi": {
      "command": "strapi-mcp-server",
      "env": {
        "STRAPI_URL": "https://your-strapi-instance.com"
      }
    }
  }
}

Claude Code (~/.claude/settings.json):

{
  "mcpServers": {
    "strapi": {
      "command": "strapi-mcp-server",
      "env": {
        "STRAPI_URL": "https://your-strapi-instance.com"
      }
    }
  }
}

Cursor: Settings → MCP Servers → Add the same configuration.

Use

After restarting your AI client:

1. AI will ask for your Strapi admin email and password
2. Once authenticated, ask it to help with content — e.g.:
   • "Show me all content types"
   • "Create a new news article about our product launch"
   • "Update the home page hero title"
   • "List all unpublished drafts"
   • "Upload this image and set the alt text"

How It Works

The MCP server connects to Strapi's admin API using your credentials. It inherits your role's permissions — if your Strapi account can't delete content, the AI can't either.

AI Client ←→ MCP Server ←→ Strapi Admin API
              (local)        (your server)

• MCP server runs locally on your machine
• Communicates with AI via stdio (standard MCP transport)
• Calls Strapi's admin REST API over HTTPS
• JWT token stored in memory only (per session)

Requirements

• Node.js 18+
• Strapi v5
• A Strapi admin account

Environment Variables

Variable	Description	Default
STRAPI_URL	Your Strapi instance URL	http://localhost:1337

Security

• Credentials are sent directly to your Strapi instance — never to third parties
• JWT tokens are stored in memory only, never persisted to disk
• The MCP server respects your Strapi role permissions
• No data leaves your infrastructure

License

MIT