other
Attio CLI for Shell Scripts
Use the Attio CLI for shell scripts with headless JSON commands, schema discovery, credentials, and permission controls.
7 functions 6 read 1 write Bearer token auth
Attio CLI for Shell Scripts
Call integration functions from shell scripts with stable JSON input and output.
Use shell scripts for small local automations that need one or more integration calls. The Attio CLI uses the same integration registry as the TUI, Lua runtime, and MCP gateway, but returns predictable command output for automation.
Command Shape
# Attio CLI for Shell Scripts
kosmokrator integrations:configure attio --set access_token="$ATTIO_ACCESS_TOKEN" --enable --read allow --write ask --json
kosmo integrations:call attio.attio_list_records '{"object_id":"example_object_id","limit":1,"offset":1,"sorts":"example_sorts","filters":"example_filters"}' --json Discovery Before Execution
Agents and scripts can inspect Attio docs and schemas before choosing a function.
kosmo integrations:docs attio --json
kosmo integrations:docs attio.attio_list_records --json
kosmo integrations:schema attio.attio_list_records --json
kosmo integrations:search "Attio" --json
kosmo integrations:list --json Useful Attio CLI Functions
| Function | Type | Parameters | Description |
|---|---|---|---|
attio.attio_list_records | Read | object_id, limit, offset, sorts, filters | List records for an object type in Attio (e.g. people, companies, deals). Supports filtering, sorting, and pagination via a POST query endpoint. Use filters to narrow results by attribute values and sorts to control ordering. |
attio.attio_get_record | Read | object_id, id | Get a single record from Attio by its object type and record ID. Returns full record details including all attribute values. |
attio.attio_create_record | Write | object_id, data | Create a new record in Attio for a given object type. Pass attribute values keyed by their attribute slug in the data parameter. |
attio.attio_list_objects | Read | none | List all object types defined in the Attio workspace (e.g. people, companies, deals, custom objects). Useful for discovering available objects before querying records. |
attio.attio_get_object | Read | id | Get details for a specific object type in Attio, including its attributes and their types. Useful for understanding what fields are available before creating or updating records. |
attio.attio_list_workspaces | Read | none | List all Attio workspaces accessible to the authenticated user. Returns workspace IDs and names useful for understanding the context of the current integration. |
attio.attio_get_current_user | Read | none | Get the currently authenticated Attio user profile. Useful for verifying API connectivity and identifying which workspace the integration is connected to. |
Automation Notes
- Use
--jsonfor machine-readable output. - Keep credentials out of argv by using environment variables or stored KosmoKrator configuration.
- Configure read/write policy before unattended runs; use
--forceonly for trusted automation. - Use the MCP gateway instead when the agent needs dynamic tool discovery inside a conversation.