Directus Skill

Universal Directus GraphQL CMS client for AI agents. Works with any Directus collection — blog posts, CRM leads, custom schemas, etc.

Features

• Collection-agnostic — works with any Directus collection schema
• Full CRUD — create, read, update, delete, count operations
• GraphQL-native — uses Directus GraphQL API directly
• Filter operators — all Directus filter operators supported
• Collection management — create/delete collections and fields (admin required)
• CLI — command-line interface for ad-hoc operations
• Type-safe errors — custom DirectusError exception class

Requirements

• Python 3.9+
• Directus 10+ instance
• API token with appropriate permissions

Quick Start

from directus import DirectusClient, DirectusError

client = DirectusClient(
    url="https://your-directus.com",
    token="your_api_token"
)

# Query
records = client.get(
    fields=["id", "title", "status"],
    filters={"status": {"_eq": "published"}},
    limit=10,
    collection="Posts"
)

# Insert
new_record = client.insert(
    {"title": "New Post", "status": "draft"},
    collection="Posts"
)

print(f"Created: {new_record['id']}")

Environment Variables

Variable	Required	Default	Description
DIRECTUS_URL	No	—	Directus instance URL
DIRECTUS_API_TOKEN	Yes	—	API token for CRUD
DIRECTUS_ADMIN_TOKEN	No	—	Admin scope (collection management)
DIRECTUS_DEFAULT_COLLECTION	No	—	Optional default collection

CLI

# Query
python -m directus query --collection Posts --fields "id title" --limit 5

# Count
python -m directus count --collection Posts

# Insert
python -m directus insert --collection Posts --data '{"title":"Hello"}'

# Health check
python -m directus health-check

Installation

pip install directus-skill

Or clone and use directly:

import sys
sys.path.insert(0, '/path/to/directus-skill')
from directus import DirectusClient

Supported Filter Operators

• _eq, _neq
• _contains, _icontains, _ncontains
• _starts_with, _istarts_with, _starts_with
• _ends_with, _iends_with, _nends_with
• _in, _nin
• _null, _nnull
• _empty, _nempty
• _gt, _gte, _lt, _lte

Full Documentation

See SKILL.md for complete documentation including:

• Collection management API
• Error handling
• CLI options
• Edge cases and known issues

License

MIT