Integration

Directus integration

Open-source headless CMS and data platform. Instantly wraps any SQL database with a real-time GraphQL and REST API. Features include customizable admin app, webhooks, flows automation, and role-based access. Used for content management, internal tools, and data-driven applications. Self-hostable with cloud option.

Connect Directus How integrations work

Ask it in chat

Say what should happen.
The workflow builds itself.

When this happens, do that in Directus.Built from the 16 Directus tools below, on the connection you add once.

Common Directus use cases

detail pages
file cleanup
image upload
user profile
image display
media library
content editing
content listing
form generation
content creation

What you can do with Directus

Each of these is one operation on one endpoint, available both as a workflow step and as a tool an AI agent can call on its own. Nothing bundles several operations into one action, so what a run did stays readable afterwards.

Most endpoints run on the free plan. A few, mainly the ones that publish on your behalf, need a paid plan.

File, 6 operations

delete_fileDelete fileDELETEDeletes a file permanently from storage. Returns empty response on success (204).
get_fileGet fileGETGets file metadata by ID. Returns type, size, dimensions, and URLs. Use /assets/{id} to download actual file.
import_fileImport filePOSTImports a file from an external URL. Provide the URL and optional metadata. Returns the imported file object.
list_filesList filesGETLists all files in the project. Filter by type, folder, or any file property. Supports sorting and pagination.
update_fileUpdate filePATCHUpdates file metadata such as title, description, tags, folder, or focal point. Returns updated file object.
upload_fileUpload filePOSTUploads a file to Directus storage. Multipart form with file data. Returns file object with ID, URL, and metadata.

Item, 5 operations

create_itemCreate itemPOSTCreates a new item in a collection. Send field values in JSON body. Returns created item with generated ID.
delete_itemDelete itemDELETEDeletes an item permanently. Returns empty response on success (204). Use soft-delete (status field) if needed.
get_itemGet itemGETGets a single item by its ID. Specify fields for partial response. Supports nested relational data and content versioning.
list_itemsList itemsGETLists items from any collection. Filter, sort, paginate, and select specific fields. Supports relational data with nested fields.
update_itemUpdate itemPATCHUpdates an existing item. Send only changed fields - others remain unchanged. Returns updated item.

Collection, 2 operations

get_collectionGet collectionGETGets a single collection by name. Returns schema, meta configuration, and field information.
list_collectionsList collectionsGETLists all collections in the project. Returns collection names, schema info, and configurations. Shows what data is available.

Asset, 1 operation

get_assetGet assetGETDownloads file content with optional image transformations. Returns binary file data. Use for: displaying images, file downloads.

Field, 1 operation

list_fieldsList fieldsGETLists all fields in a collection. Returns field names, types, validations, and display configurations. Schema introspection.

User, 1 operation

get_current_userGet current userGETGets the authenticated user's profile. Returns user details, role, and permissions. Use for user context and authorization.

Use Directus from Claude Code, Cursor or Codex

Connect Directus in LiveContext, create an API key in Settings, then add the LiveContext MCP server to your client. Its Directus operations become tools the client can call, next to every other integration you connected.

Claude Code

claude mcp add --transport http livecontext https://livecontext.ai/mcp --header "X-API-Key: YOUR_API_KEY"

Codex (~/.codex/config.toml)

[mcp_servers.livecontext]
url = "https://livecontext.ai/mcp"

[mcp_servers.livecontext.http_headers]
"X-API-Key" = "YOUR_API_KEY"

Cursor, Claude Desktop and other JSON configs

{
  "mcpServers": {
    "livecontext": {
      "type": "http",
      "url": "https://livecontext.ai/mcp",
      "headers": {
        "X-API-Key": "YOUR_API_KEY"
      }
    }
  }
}

Set up the MCP server step by step

How to connect Directus

Create your workspace
Sign up free. Nothing to install.
Connect Directus once
Add your Directus connection in Settings. Every tool from this integration reuses it, and secrets are encrypted at rest and visible only to you.
Describe the job in chat
The workflow builds itself in front of you and picks the endpoints it needs. Drag the steps yourself on the canvas whenever you would rather be explicit.

Directus integration FAQ

What can you do with the Directus integration?

LiveContext exposes 16 operations on Directus, covering file, item, collection and asset. Common uses include detail pages, file cleanup and image upload.