Best for
- Content teams already on Directus who want to read and write content via LLMs
- Analysts querying Directus data with natural language
- Directus projects wanting controlled, guardrailed data access for non-developers
D
Directus Content MCP Server
Official
Let LLMs interact directly with your Directus data.
GitHub source repository ↗
70FMRS · B
An officially maintained MCP server for Directus data with comprehensive tool coverage (items, files, fields, flows, comments, prompts), built-in guardrails against data loss, and solid config options. Ideal for content and analysis workflows; useless outside Directus, and intentionally restrictive for developers needing destructive operations.
The Directus Content MCP Server is the official MCP interface for Directus users to interact with their data in LLMs. Content editors can build pages, write blog posts, and organize assets, while data analysts can query collections, generate reports, and extract insights using natural language. It intentionally limits destructive actions like deleting fields or collections, and supports system prompts, dynamic prompts stored in Directus collections, Mustache templating, and tool restrictions via DISABLE_TOOLS.
Tools
system-prompt
Provides context to the LLM assistant about its role
users-me
Get current user information
read-collections
Retrieve the schema of all collections
read-items
Fetch items from any collection
create-item
Create new items in collections
update-item
Modify existing items
delete-item
Remove items from collections
read-files
Access file metadata or raw content
import-file
Import files from URLs
update-files
Update file metadata
read-fields
Get field definitions for collections
read-field
Get specific field information
create-field
Add new fields to collections
update-field
Modify existing fields
read-flows
List available automation flows
trigger-flow
Execute automation flows
read-comments
View comments on items
upsert-comment
Add or update comments
markdown-tool
Convert between markdown and HTML
get-prompts
List available prompts
get-prompt
Execute a stored prompt
Setup
Prerequisite: an existing Directus project (free trial on Directus Cloud, or run npx directus-template-cli@latest init locally). Step 1: get credentials — generate a static token in your user profile (remember to save the user) or use email and password. Step 2: add the server to Claude Desktop or Cursor MCP config with command npx @directus/content-mcp@latest and env vars DIRECTUS_URL plus DIRECTUS_TOKEN (or DIRECTUS_USER_EMAIL / DIRECTUS_USER_PASSWORD), save and restart the client. Local dev: clone the repo, run pnpm install && pnpm build, point the config at dist/index.js, and use pnpm dev to watch changes.
claude_desktop_config.json
{"mcpServers":{"directus":{"command":"npx","args":["@directus/content-mcp@latest"],"env":{"DIRECTUS_URL":"https://your-directus-url.com","DIRECTUS_TOKEN":"your-directus-token"}}}}
Fit and risk
Not for
- Projects not using Directus
- Developers needing full destructive/admin operations on dev instances (field and collection deletion is intentionally limited)
- Clients that do not support MCP
Required permissions
- Requires the Directus instance URL plus a static token or email/password credentials
- Actions are limited by the permissions of the associated Directus user
Risks and side effects
- Has write access to create, update, and delete items and fields, so misconfiguration can still modify data
- Leaked credentials grant LLM access to Directus data
- While field/collection deletion is limited, item deletion remains available
Troubleshooting
- If a static token shows 'Invalid token!', check that you saved the user after generating the token
- Verify DIRECTUS_URL and credentials replace all placeholder values
- Restart Claude Desktop after editing config to see the Directus MCP icon
- In Cursor, check Settings/MCP for a green active status
Use cases
Content editors build custom pages, write blog posts, update content, and organize assets
Data analysts query collections, generate reports, and analyze trends in natural language
Trigger automation flows for bulk operations, publishing, or status changes
Format content between Markdown and HTML for WYSIWYG fields
Supported clients
Claude DesktopFull support
CursorFull support