Directus MCP Server

A Node.js server implementing Model Context Protocol (MCP) for Directus CMS. Enable AI Clients to interact with the Directus API through the Model Context Protocol (MCP).

ℹ Prerequisites

• Node.js

• NPM

• A Directus Instance

▶️ Quick start

1. Get your Directus API credentials

   • Go to your Directus instance

   • Create a static access token or get your email and password

   • Keep these credentials secure

2. Add to your AI editor

   { "mcpServers": { "directus": { "command": "npx", "args": ["-y", "@pixelsock/directus-mcp@latest"], "env": { "DIRECTUS_URL": "https://your-directus-instance.com", "DIRECTUS_ACCESS_TOKEN": "YOUR_ACCESS_TOKEN" } } } }

   Alternatively, you can use email/password authentication:

   { "mcpServers": { "directus": { "command": "npx", "args": ["-y", "@pixelsock/directus-mcp@latest"], "env": { "DIRECTUS_URL": "https://your-directus-instance.com", "DIRECTUS_EMAIL": "your-email@example.com", "DIRECTUS_PASSWORD": "your-password" } } } }

   For Cursor:

   1. Go to Settings → Cursor Settings → MCP

   2. Click + Add New Global MCP Server

   3. Paste configuration

   4. Replace placeholder values with your Directus credentials

   5. Save and restart Cursor

   For Claude Desktop:

   1. Open Settings → Developer

   2. Click Edit Config

   3. Open claude_desktop_config.json in a code editor and paste configuration

   4. Replace placeholder values with your Directus credentials

   5. Save and restart Claude

❓ Troubleshooting

If you are having issues starting the server in your MCP client e.g. Cursor or Claude Desktop, please try the following.

Ensure you have valid Directus credentials

1. Verify that your Directus URL is correct and accessible

2. Check that your access token or email/password credentials are valid

3. Replace the credentials in your MCP client configuration

4. Save and restart your MCP client

Ensure you have Node and NPM installed

• Node.js

• NPM

Run the following commands to confirm you have Node and NPM installed:

Clear your NPM cache

Sometimes clearing your NPM cache can resolve issues with npx.

🛠️ Available tools

Collections and Items

Files

Users and Permissions

System

🚧 Development mode

If you want to run the server in development mode:

1. Clone and install:

   git clone https://github.com/pixelsock/directus-mcp.git cd directus-mcp npm install

2. Add your credentials to .env:

   # .env DIRECTUS_URL=https://your-directus-instance.com DIRECTUS_ACCESS_TOKEN=your_token_here # Or use email/password DIRECTUS_EMAIL=your-email@example.com DIRECTUS_PASSWORD=your-password

3. Start development server:

   npm run dev

📄 Directus Developer resources

• Directus API Documentation

• Directus API Endpoints

• Directus JavaScript SDK