Directus MCP Server

What is Directus MCP Server?

A Node.js server implementing the Model Context Protocol (MCP) for Directus CMS. It enables AI clients to interact with the Directus API through MCP, allowing AI-driven content management and data operations.

How to use Directus MCP Server?

Configure the server in your MCP client (e.g., Cursor or Claude Desktop) using npx with environment variables for your Directus URL and authentication credentials (access token or email/password). The server runs via stdio by default, with an optional HTTP transport for remote deployments.

Key features of Directus MCP Server

• Manage collections and items (CRUD operations)
• Upload and retrieve files from Directus
• Authenticate users and manage permissions
• Fetch system information and activity logs
• Supports both stdio and Streamable HTTP transport
• Works with Cursor, Claude Desktop, and other MCP clients

Use cases of Directus MCP Server

• AI assistant that creates, updates, or deletes content in Directus
• Automated data retrieval and reporting from Directus collections
• File management (uploading and fetching assets) via AI
• User and role management operations through natural language
• Remote multi-user content management using HTTP transport

FAQ from Directus MCP Server

What do I need to run this server?

You need Node.js and NPM installed, plus a running Directus instance with valid credentials (access token or email/password).

How do I authenticate with Directus?

Set DIRECTUS_URL and either DIRECTUS_ACCESS_TOKEN or both DIRECTUS_EMAIL and DIRECTUS_PASSWORD in the server’s environment configuration.

What transport modes are supported?

The default is stdio for local AI editors. Set MCP_TRANSPORT=http (or streamable-http) for remote multi-user deployments.

How do I fix startup issues in my MCP client?

Verify your Directus credentials are correct and accessible, ensure Node and NPM are installed, and try clearing your NPM cache with npm cache clean --force.

Where can I find more Directus developer resources?

Official Directus API documentation, REST API endpoints, and JavaScript SDK are available at docs.directus.io.