Can I use Sanity as a CLI?

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

Can I expose Sanity through MCP?

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

Where are Sanity credentials stored?

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

Can I deny write access for Sanity MCP tools?

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

data

Sanity CLI for Headless Automation

Use the Sanity CLI for headless automation with headless JSON commands, schema discovery, credentials, and permission controls.

7 functions 4 read 3 write API token auth

Submit Sanity feedback View package source

Sanity CLI for Headless Automation

Use KosmoKrator as a non-interactive integration runtime for local automations and wrappers.

Use headless automation when another tool needs a stable local command surface. The Sanity CLI uses the same integration registry as the TUI, Lua runtime, and MCP gateway, but returns predictable command output for automation.

Command Shape

# Sanity CLI for Headless Automation
kosmokrator integrations:configure sanity --set api_token="$SANITY_API_TOKEN" --set project_id="$SANITY_PROJECT_ID" --enable --read allow --write ask --json
kosmo integrations:call sanity.sanity_query_documents '{"query":"example_query","params":"example_params"}' --json

Discovery Before Execution

Agents and scripts can inspect Sanity docs and schemas before choosing a function.

kosmo integrations:docs sanity --json
kosmo integrations:docs sanity.sanity_query_documents --json
kosmo integrations:schema sanity.sanity_query_documents --json
kosmo integrations:search "Sanity" --json
kosmo integrations:list --json

Useful Sanity CLI Functions

Function	Type	Parameters	Description
`sanity.sanity_query_documents`	Read	query, params	Query documents in Sanity using GROQ (Graph-Relational Object Queries). Returns matching documents with their fields.
`sanity.sanity_get_document`	Read	id	Retrieve a single Sanity document by its ID. Returns the full document with all fields.
`sanity.sanity_create_document`	Write	document	Create a new document in the Sanity dataset. The document data must include a _type field matching a schema type.
`sanity.sanity_update_document`	Write	id, set	Update an existing Sanity document by applying a patch with the specified fields.
`sanity.sanity_delete_document`	Write	id	Delete a document from the Sanity dataset by its ID. This action is permanent.
`sanity.sanity_list_projects`	Read	none	List all Sanity projects accessible to the authenticated user. Requires a management API token.
`sanity.sanity_get_current_user`	Read	none	Get the currently authenticated Sanity user. Useful for verifying credentials and checking user identity.

Automation Notes

Use --json for machine-readable output.
Keep credentials out of argv by using environment variables or stored KosmoKrator configuration.
Configure read/write policy before unattended runs; use --force only for trusted automation.
Use the MCP gateway instead when the agent needs dynamic tool discovery inside a conversation.

Related Sanity CLI Pages

CI Sanity CLI for CI. Cron Jobs Sanity CLI for cron jobs. Shell Scripts Sanity CLI for shell scripts. Coding Agents Sanity CLI for coding agents.