Skip to content
Directus Content MCP Server

Directus Content MCP Server

v0.1.0
MIT
directuscmsheadless-cmscontentno-code

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

New

Official MCP server for Meilisearch — create and configure indexes, add documents, run hybrid and semantic searches, and manage API keys and tasks through conversation.

Web & SearchDatabases & Data
New

Metabase's built-in MCP server — search, query and visualise your BI data through the semantic layer, scoped to the connecting person's existing Metabase permissions.

Databases & DataProductivity
New

Amplitude's official hosted MCP server with 50+ tools over analytics, cohorts, experiments, feature flags, taxonomy and session replay, secured by OAuth and existing RBAC roles.

Databases & DataProductivity
1 views

MCP: deja-vu

by Vladislav Shulcz

New

Indexes the coding-agent sessions already sitting on your disk — months of history from before you installed it — and serves them back over MCP. 3.5 GB searched in ~1.5 ms, no LLM, no embeddings.

Developer ToolsDatabases & Data
1 views
Browse all MCP servers →