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