Connects to a Directus API instance, allowing AI tools to read items from collections, access current user information, and view available collections and fields in the system.
Warning
This was an experimental MCP server to test the waters and see what it would allow us to do. We've since released an official Directus MCP server over on https://github.com/directus/mcp 🙂
Directus Model Context Protocol (MCP) Server
MCP server for use with Directus. Allows your AI tools to connect to and use your Directus API on your behalf.
This is an experiment by yours truly (@rijkvanzanten). Any and all PRs are more than welcome :)
Installation
This MCP server is built to work with NodeJS v22.12 or newer.
Global Installation (Recommended)
npm install -g @rijk/directus-mcp-server
Then configure Claude AI to use the npm
package as remote server:
Local / Dev Installation
- Clone the repo
pnpm install && pnpm build
to build the server- Configure Claude AI like above, but pointing it to the
dist
file instead:
Tools
Read Items
The read-items
tool allows you to read items from any Directus collection by providing the collection name as a parameter.
Parameters:
collection
: (required) The name of the collection to read fromfields
: (optional) Array of field names to returnsort
: (optional) Field to sort by (prefix with-
for descending order)limit
: (optional) Maximum number of items to return
Example:
Read Current User
Get information about the current user. Effectively the /users/me
endpoint.
Read Collections
Return what collections/fields are available in the system. Use this tool first to discover available collections before using the read-items
tool.
License
MIT
This server cannot be installed
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
A Model Context Protocol server that allows AI tools to connect to and interact with your Directus API, enabling automated access to collections, items, and user data.
Related MCP Servers
- AsecurityFlicenseAqualityA Node.js server that enables AI Clients to interact with the Directus CMS API through the Model Context Protocol, allowing for management of collections, items, files, users, and system information.Last updated -1815TypeScript
- -securityAlicense-qualityA server that implements the Model Context Protocol, providing a standardized way to connect AI models to different data sources and tools.Last updated -28TypeScriptMIT License
- -securityFlicense-qualityA Model Context Protocol server that provides AI models with structured access to external data and services, acting as a bridge between AI assistants and applications, databases, and APIs in a standardized, secure way.Last updated -1Python
- -securityAlicense-qualityAn extension that implements the Model Context Protocol for Directus, enabling AI tools and LLMs to interact with Directus content through natural language for content editing, data analysis, and asset management.Last updated -46TypeScriptMIT License