Directus MCP Server

An MCP (Model Context Protocol) server that connects your AI assistant (Claude, Cursor, etc.) to a Directus instance. Ask your AI to read content, manage schema, create automation flows, and more — all through natural language.

Features

• Content Management — Read, create, and update items across your Directus collections
• Schema Management — Create and modify collections, fields, and relations
• Flow Automation — Build and trigger Directus flows with operations and conditions
• File Management — Read, update, and import files and assets
• User & Comments — Read users and manage comments on collection items
• Content Conversion — Convert between HTML and Markdown
• Prompt Management — Serve LLM prompts from a Directus collection (optional)
• Safe Defaults — Destructive operations (delete) are disabled by default
• Scoped Access — Exclude sensitive collections from AI access via configuration

Quick Start

Prerequisites

• A running Directus instance (Directus Cloud or self-hosted)
• A Directus API token or user credentials

Installation

Using npx (Recommended)

No installation needed. Add to your MCP client configuration (Claude Desktop / Claude Code / Cursor):

{
  "mcpServers": {
    "directus": {
      "command": "npx",
      "args": ["-y", "@archawat/mcp-directus"],
      "env": {
        "DIRECTUS_URL": "https://your-instance.com",
        "DIRECTUS_TOKEN": "your-token"
      }
    }
  }
}

Global Install

npm install -g @archawat/mcp-directus

Then configure your MCP client:

{
  "mcpServers": {
    "directus": {
      "command": "mcp-directus",
      "env": {
        "DIRECTUS_URL": "https://your-instance.com",
        "DIRECTUS_TOKEN": "your-token"
      }
    }
  }
}

Available Tools

Discovery

Schema

Fields

Relations

Items

Flows

Operations (Flow Steps)

Users

Comments

Files & Assets

Utilities

Prompts (Optional)

Configuration

Environment Variables

# Required — Directus instance URL
DIRECTUS_URL=https://your-instance.com

# Authentication (use token OR email/password)
DIRECTUS_TOKEN=your-token
DIRECTUS_USER_EMAIL=user@example.com
DIRECTUS_USER_PASSWORD=password

# Disable specific tools (comma-separated, uses full tool names)
# Default: directus_delete_item
DISABLE_TOOLS=directus_delete_item,directus_delete_flow,directus_delete_operation,directus_delete_relation

# Exclude collections from AI access (comma-separated)
SCHEMA_EXCLUDE_COLLECTIONS=logs,cache,temp_data

# Allow modifying Directus system collections (disabled by default)
ALLOW_SYSTEM_MODIFICATIONS=false

# System prompt configuration
MCP_SYSTEM_PROMPT_ENABLED=true          # Enable the system prompt tool (default: true)
MCP_SYSTEM_PROMPT=                       # Custom system prompt override (optional)

# LLM Prompts collection (disabled by default)
DIRECTUS_PROMPTS_COLLECTION_ENABLED=false
DIRECTUS_PROMPTS_COLLECTION=prompts              # Collection name storing LLM prompts
DIRECTUS_PROMPTS_NAME_FIELD=name                 # Field for prompt name
DIRECTUS_PROMPTS_DESCRIPTION_FIELD=description   # Field for prompt description
DIRECTUS_PROMPTS_SYSTEM_PROMPT_FIELD=system_prompt  # Field for system prompt text
DIRECTUS_PROMPTS_MESSAGES_FIELD=messages          # Field for prompt messages

SCHEMA_EXCLUDE_COLLECTIONS

Excludes specific collections from schema loading and all tool operations. Useful for:

• Performance — Skip large log or cache collections
• Security — Prevent AI access to sensitive data
• Focus — Limit the AI to only relevant collections

SCHEMA_EXCLUDE_COLLECTIONS=activity_logs,cache,temp_uploads,user_sessions

ALLOW_SYSTEM_MODIFICATIONS

Controls whether the AI can modify Directus system collections (directus_users, directus_roles, directus_permissions, etc.). Disabled by default.

• false (default) — Blocks create/update on system collections (read is always allowed)
• true — Allows system collection modifications. Use with caution; incorrect changes can break your Directus instance

DISABLE_TOOLS

Comma-separated list of tool names to disable. Default: directus_delete_item.

# Disable all destructive operations
DISABLE_TOOLS=directus_delete_item,directus_delete_flow,directus_delete_operation,directus_delete_relation

DIRECTUS_PROMPTS_COLLECTION_ENABLED

When enabled, exposes the directus_get_prompts tool which reads LLM prompts from a Directus collection. Requires DIRECTUS_PROMPTS_COLLECTION to specify the collection name. The field mapping variables (*_FIELD) let you customize which fields store the prompt name, description, system prompt, and messages.

Local Development

git clone https://github.com/archawat/mcp-directus
cd mcp-directus
pnpm install
pnpm build
pnpm dev

For local MCP client testing, use the local path:

{
  "mcpServers": {
    "directus": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-directus/dist/index.js"],
      "env": {
        "DIRECTUS_URL": "https://your-instance.com",
        "DIRECTUS_TOKEN": "your-token"
      }
    }
  }
}

Contributing

Please open issues for bugs or suggestions.

License

MIT

Acknowledgments

• Original project by @rijkvanzanten and the Directus team