Skip to content
Directus Content MCP Server

Directus Content MCP Server

Released
2 views
v0.1.0
MIT

Summary

Official Directus MCP server for content teams — browse collections and schema, create and edit items, manage files and comments, and trigger flows from an AI client.

Features

  • Read the collections schema and field definitions before querying
  • Read, create, update and delete items across collections
  • Manage files and asset metadata for page-building workflows
  • Trigger Directus Flows to hand off to existing automation
  • Read and write item comments for an editorial trail
  • Configurable system prompt and mustache-templated custom prompts stored in Directus
  • Destructive schema operations deliberately withheld; DISABLE_TOOLS narrows the surface further

Installation

Set up this MCP server in your favorite AI agent — copy a ready-made configuration below.

Any MCP-compatible agent

Most agents (Claude, Cursor, Windsurf, VS Code, and more) read a standard mcpServers configuration.

  1. Open your agent's MCP configuration file.
  2. Merge the snippet below into it, filling in the environment variables with your own values.
  3. Restart the agent — the "Directus Content MCP Server" tools will be available.
{
  "mcpServers": {
    "directus-content-mcp": {
      "command": "npx",
      "args": [
        "@directus/content-mcp@latest"
      ],
      "env": {
        "DIRECTUS_URL": "https://your-instance.directus.app",
        "DIRECTUS_TOKEN": "your_static_token"
      }
    }
  }
}

Description

The Directus Content MCP Server connects an MCP client to a Directus instance so that the people who actually work in the CMS — editors assembling pages, analysts pulling numbers out of collections — can do it in conversation rather than through the admin UI.

What it exposes

Twenty-odd tools, grouped roughly as:

  • Schema and discovery — read the collections schema and field definitions so the model knows what your data model looks like before it queries it.
  • Items — read, create, update and delete items in a collection, with Directus's normal filter and field-selection semantics.
  • Files — fetch file metadata and manage assets, which is the piece that makes "build me this page" workflows practical.
  • Flows — trigger Directus Flows, so an agent can hand off to automation you have already built.
  • Comments — read and write item comments, keeping an editorial trail in the same place the team already looks.
  • Prompts — a configurable system prompt plus custom prompt templates stored in a Directus collection, with mustache templating, so an organisation can ship its own house instructions alongside the data.
  • Utility — markdown conversion and current-user lookup.
Deliberate guardrails

The genuinely destructive schema operations — deleting fields, deleting collections — are intentionally left out. The server can churn content but cannot quietly demolish the data model behind it. DISABLE_TOOLS narrows the surface further if you want a read-mostly deployment.

Setup

Runs straight from npm: npx @directus/content-mcp@latest. Authenticate with DIRECTUS_URL plus either a static DIRECTUS_TOKEN or DIRECTUS_USER_EMAIL and DIRECTUS_USER_PASSWORD. Because Directus applies its own role and permission model to whatever credential you supply, the cleanest setup is a dedicated role scoped to exactly the collections the agent should see. MIT licensed.

Related MCP Servers

Featured

InfluxData's official MCP server for InfluxDB 3 — schema discovery, bounded SQL and InfluxQL queries, line-protocol writes and token administration across Core, Enterprise and Cloud.

Featured

Mixpanel's official hosted MCP server — 80+ tools for querying product analytics, building boards, managing cohorts and metrics, and reading session replays.

Browse all MCP servers →