Can I use Directus as a CLI?

Yes. KosmoKrator exposes a Directus CLI through kosmo integrations:call and the provider shortcut command. Commands can return JSON for scripts, CI, and coding agents.

Can I expose Directus through MCP?

Yes. The KosmoKrator MCP gateway can expose selected Directus tools to clients such as Claude Code, Cursor, Codex, and other MCP-compatible tools.

Where are Directus credentials stored?

Directus credentials are configured in KosmoKrator's local integration settings and reused by CLI, Lua, and MCP gateway surfaces.

Can I deny write access for Directus MCP tools?

Yes. Start the gateway with --write=deny for read-only clients, or use ask/allow only for trusted workspaces.

data

Directus MCP, CLI, and Lua Integration for AI Agents

Directus integration docs for AI agents: MCP gateway setup, Directus CLI commands, Lua API reference, credentials, and function schemas.

Directus for agents

Credentials can be configured manually in web or CLI hosts.

Use this integration from Lua code mode, the headless integrations CLI, or the KosmoKrator MCP gateway. The same package metadata powers all three surfaces.

Agent Surfaces

Directus CLIHeadless setup, JSON output, direct function calls. Directus MCPExpose selected tools to local MCP clients. Directus LuaAgent-facing namespace and Lua reference. FeedbackReport missing tools, auth issues, or bad metadata.

Machine-Readable Metadata

integration_slug: directus
route_slug: directus
package: directus
auth_strategy: bearer_token
cli_setup_supported: true
cli_runtime_supported: true
mcp_gateway_supported: true
lua_supported: true

Function Catalog

Function	Type	Description
`directus.directus_get_activities`	Read `read`	Returns a list of activity actions.
`directus.directus_get_activity`	Read `read`	Retrieves the details of an existing activity action. Provide the primary key of the activity action and Directus will return the corresponding information.
`directus.directus_get_asset`	Read `read`	Image typed files can be dynamically resized and transformed to fit any need.
`directus.directus_login`	Write `write`	Retrieve a Temporary Access Token
`directus.directus_refresh`	Write `write`	Refresh a Temporary Access Token.
`directus.directus_logout`	Write `write`	Log Out
`directus.directus_password_request`	Write `write`	Request that a password reset email be sent. This does not apply to users authenticated through external providers OAuth, SAML, LDAP, etc..
`directus.directus_password_reset`	Write `write`	The request a password reset endpoint sends an email with a link to the admin app which in turn uses this endpoint to allow the user to reset their password.
`directus.directus_oauth`	Read `read`	List configured OAuth providers.
`directus.directus_oauth_provider`	Read `read`	Start OAuth flow using the specified provider
`directus.directus_list_items`	Read `read`	List the items.
`directus.directus_create_item`	Write `write`	Create a new item.
`directus.directus_update_items`	Write `write`	Update multiple items at the same time.
`directus.directus_delete_items`	Write `write`	Delete multiple existing items.
`directus.directus_get_item`	Read `read`	Retrieve a single item by unique identifier.
`directus.directus_update_item`	Write `write`	Update an existing item.
`directus.directus_delete_item`	Write `write`	Delete an existing item.
`directus.directus_get_presets`	Read `read`	List the presets.
`directus.directus_create_preset`	Write `write`	Create a new preset.
`directus.directus_update_presets`	Write `write`	Update multiple presets at the same time.
`directus.directus_delete_presets`	Write `write`	Delete multiple existing presets.
`directus.directus_get_preset`	Read `read`	Retrieve a single preset by unique identifier.
`directus.directus_update_preset`	Write `write`	Update an existing preset.
`directus.directus_delete_preset`	Write `write`	Delete an existing preset.
`directus.directus_list_collections`	Read `read`	Returns a list of the collections available in the project.
`directus.directus_create_collection`	Write `write`	Create a new collection in Directus.
`directus.directus_get_collection`	Read `read`	Retrieves the details of a single collection.
`directus.directus_update_collection`	Write `write`	Update an existing collection.
`directus.directus_delete_collection`	Write `write`	Delete an existing collection. Warning: This will delete the whole collection, including the items within. Proceed with caution.
`directus.directus_get_comments`	Read `read`	List the comments.
`directus.directus_create_comment`	Write `write`	Create a new comment.
`directus.directus_update_comments`	Write `write`	Update multiple comments at the same time.
`directus.directus_delete_comments`	Write `write`	Delete multiple existing comments.
`directus.directus_get_comment`	Read `read`	Retrieve a single comment by unique identifier.
`directus.directus_update_comment`	Write `write`	Update an existing comment.
`directus.directus_delete_comment`	Write `write`	Delete an existing comment.
`directus.directus_list_extensions`	Read `read`	List the installed extensions and their configuration in the project.
`directus.directus_update_extensions`	Write `write`	Update an existing extension.
`directus.directus_update_extension_bundle`	Write `write`	Update an existing extension.
`directus.directus_get_fields`	Read `read`	Returns a list of the fields available in the project.
`directus.directus_get_collection_fields`	Read `read`	Returns a list of the fields available in the given collection.
`directus.directus_create_field`	Write `write`	Create a new field in a given collection.
`directus.directus_get_collection_field`	Read `read`	Retrieves the details of a single field in a given collection.
`directus.directus_update_field`	Write `write`	Update an existing field.
`directus.directus_delete_field`	Write `write`	Delete an existing field.
`directus.directus_get_files`	Read `read`	List the files.
`directus.directus_create_file`	Write `write`	Create a new file
`directus.directus_update_files`	Write `write`	Update multiple files at the same time.
`directus.directus_delete_files`	Write `write`	Delete multiple existing files.
`directus.directus_get_file`	Read `read`	Retrieve a single file by unique identifier.
`directus.directus_update_file`	Write `write`	Update an existing file, and/or replace it's file contents.
`directus.directus_delete_file`	Write `write`	Delete an existing file.
`directus.directus_get_flows`	Read `read`	Get all flows.
`directus.directus_create_flow`	Write `write`	Create a new flow.
`directus.directus_update_flows`	Write `write`	Update multiple flows at the same time.
`directus.directus_delete_flows`	Write `write`	Delete multiple existing flows.
`directus.directus_get_flow`	Read `read`	Retrieve a single flow by unique identifier.
`directus.directus_update_flow`	Write `write`	Update an existing flow
`directus.directus_delete_flow`	Write `write`	Delete an existing flow
`directus.directus_get_folders`	Read `read`	List the folders.
`directus.directus_create_folder`	Write `write`	Create a new folder.
`directus.directus_update_folders`	Write `write`	Update multiple folders at the same time.
`directus.directus_delete_folders`	Write `write`	Delete multiple existing folders.
`directus.directus_get_folder`	Read `read`	Retrieve a single folder by unique identifier.
`directus.directus_update_folder`	Write `write`	Update an existing folder
`directus.directus_delete_folder`	Write `write`	Delete an existing folder
`directus.directus_get_operations`	Read `read`	Get all operations.
`directus.directus_create_operation`	Write `write`	Create a new operation.
`directus.directus_update_operations`	Write `write`	Update multiple operations at the same time.
`directus.directus_delete_operations`	Write `write`	Delete multiple existing operations.
`directus.directus_get_operation`	Read `read`	Retrieve a single operation by unique identifier.
`directus.directus_update_operation`	Write `write`	Update an existing operation
`directus.directus_delete_operation`	Write `write`	Delete an existing operation
`directus.directus_get_permissions`	Read `read`	List all permissions.
`directus.directus_create_permission`	Write `write`	Create a new permission.
`directus.directus_update_permissions`	Write `write`	Update multiple permissions at the same time.
`directus.directus_delete_permissions`	Write `write`	Delete multiple existing permissions.
`directus.directus_get_my_permissions`	Read `read`	List the permissions that apply to the current user.
`directus.directus_get_permission`	Read `read`	Retrieve a single permissions object by unique identifier.
`directus.directus_update_permission`	Write `write`	Update an existing permission
`directus.directus_delete_permission`	Write `write`	Delete an existing permission
`directus.directus_get_relations`	Read `read`	List the relations.
`directus.directus_create_relation`	Write `write`	Create a new relation.
`directus.directus_get_relation`	Read `read`	Retrieve a single relation by unique identifier.
`directus.directus_update_relation`	Write `write`	Update an existing relation
`directus.directus_delete_relation`	Write `write`	Delete an existing relation.
`directus.directus_get_revisions`	Read `read`	List the revisions.
`directus.directus_get_revision`	Read `read`	Retrieve a single revision by unique identifier.
`directus.directus_get_roles`	Read `read`	List the roles.
`directus.directus_create_role`	Write `write`	Create a new role.
`directus.directus_update_roles`	Write `write`	Update multiple roles at the same time.
`directus.directus_delete_roles`	Write `write`	Delete multiple existing roles.
`directus.directus_get_role`	Read `read`	Retrieve a single role by unique identifier.
`directus.directus_update_role`	Write `write`	Update an existing role
`directus.directus_delete_role`	Write `write`	Delete an existing role
`directus.directus_schema_snapshot`	Read `read`	Retrieve the current schema. This endpoint is only available to admin users.
`directus.directus_schema_apply`	Write `write`	Update the instance's schema by passing the diff previously retrieved via /schema/diff endpoint in the JSON request body or a JSON/YAML file. This endpoint is only available to admin users.
`directus.directus_schema_diff`	Write `write`	Compare the current instance's schema against the schema snapshot in JSON request body or a JSON/YAML file and retrieve the difference. This endpoint is only available to admin users.
`directus.directus_server_info`	Read `read`	Perform a system status check and return the options.
`directus.directus_ping`	Read `read`	Ping, pong. Ping.. pong.
`directus.directus_get_settings`	Read `read`	List the settings.
`directus.directus_update_setting`	Write `write`	Update the settings
`directus.directus_get_users`	Read `read`	List the users.
`directus.directus_create_user`	Write `write`	Create a new user.
`directus.directus_update_users`	Write `write`	Update multiple users at the same time.
`directus.directus_delete_users`	Write `write`	Delete multiple existing users.
`directus.directus_get_user`	Read `read`	Retrieve a single user by unique identifier.
`directus.directus_update_user`	Write `write`	Update an existing user
`directus.directus_delete_user`	Write `write`	Delete an existing user
`directus.directus_invite`	Write `write`	Invites one or more users to this project. It creates a user with an invited status, and then sends an email to the user with instructions on how to activate their account.
`directus.directus_accept_invite`	Write `write`	Accepts and enables an invited user using a JWT invitation token.
`directus.directus_get_current_user`	Read `read`	Retrieve the currently authenticated user.
`directus.directus_update_me`	Write `write`	Update the currently authenticated user.
`directus.directus_update_last_used_page_me`	Write `write`	Updates the last used page field of the currently authenticated user. This is used internally to be able to open the Directus admin app from the last page you used.
`directus.directus_me_tfa_enable`	Write `write`	Enables two-factor authentication for the currently authenticated user.
`directus.directus_me_tfa_disable`	Write `write`	Disables two-factor authentication for the currently authenticated user.
`directus.directus_hash_generate`	Write `write`	Generate a hash for a given string.
`directus.directus_hash_verify`	Write `write`	Generate a hash for a given string.
`directus.directus_sort`	Write `write`	Re-sort items in collection based on start and to value of item
`directus.directus_import`	Write `write`	Import multiple records from a JSON or CSV file into a collection.
`directus.directus_export`	Write `write`	Export a larger data set to a file in the File Library
`directus.directus_clear_cache`	Write `write`	Resets both the data and schema cache of Directus.
`directus.directus_random`	Read `read`	Returns a random string of given length.
`directus.directus_get_content_versions`	Read `read`	Get all Content Versions.
`directus.directus_create_content_version`	Write `write`	Create multiple new Content Versions.
`directus.directus_update_content_versions`	Write `write`	Update multiple Content Versions at the same time.
`directus.directus_delete_content_versions`	Write `write`	Delete multiple existing Content Versions.
`directus.directus_get_content_version`	Read `read`	Retrieve a single Content Version by unique identifier.
`directus.directus_update_content_version`	Write `write`	Update an existing Content Version.
`directus.directus_delete_content_version`	Write `write`	Delete an existing Content Version.
`directus.directus_save_content_version`	Write `write`	Save item changes to an existing Content Version.
`directus.directus_compare_content_version`	Read `read`	Compare an existing Content Version with the main version of the item.
`directus.directus_promote_content_version`	Write `write`	Pass the current hash of the main version of the item obtained from the compare endpoint along with an optional array of field names of which the values are to be promoted by default, all fields are selected.