sales
Insightly CRM CLI for Coding Agents
Use the Insightly CRM CLI for coding agents with headless JSON commands, schema discovery, credentials, and permission controls.
7 functions 6 read 1 write Bearer token auth
Insightly CRM CLI for Coding Agents
Let coding agents discover schemas and execute integration functions through CLI commands or MCP.
Use this pattern when another coding agent needs exact commands and schema discovery. The Insightly CRM CLI uses the same integration registry as the TUI, Lua runtime, and MCP gateway, but returns predictable command output for automation.
Command Shape
# Insightly CRM CLI for Coding Agents
kosmokrator integrations:configure insightly --set access_token="$INSIGHTLY_ACCESS_TOKEN" --enable --read allow --write ask --json
kosmo integrations:call insightly.insightly_list_contacts '{"top":1,"skip":1,"search":"example_search"}' --jsonDiscovery Before Execution
Agents and scripts can inspect Insightly CRM docs and schemas before choosing a function.
kosmo integrations:docs insightly --json
kosmo integrations:docs insightly.insightly_list_contacts --json
kosmo integrations:schema insightly.insightly_list_contacts --json
kosmo integrations:search "Insightly CRM" --json
kosmo integrations:list --jsonUseful Insightly CRM CLI Functions
| Function | Type | Parameters | Description |
|---|---|---|---|
insightly.insightly_list_contacts | Read | top, skip, search | List contacts from Insightly CRM. Returns contact records with names, emails, phones, and organization info. Use top/skip for pagination and search to filter by name or email. |
insightly.insightly_get_contact | Read | id | Get detailed information about a single Insightly contact by ID. Returns all contact fields including addresses, emails, phones, and linked organizations. |
insightly.insightly_create_contact | Write | first_name, last_name, email, phone | Create a new contact in Insightly CRM. Provide contact details such as first name, last name, email, and phone. Returns the created contact with its new ID. |
insightly.insightly_list_opportunities | Read | top, skip, status | List opportunities from Insightly CRM. Returns opportunity records with names, amounts, stages, and pipeline info. Use top/skip for pagination and status to filter by opportunity state. |
insightly.insightly_get_opportunity | Read | id | Get detailed information about a single Insightly opportunity by ID. Returns all opportunity fields including amount, stage, pipeline, and linked contacts. |
insightly.insightly_list_projects | Read | top, skip, status | List projects from Insightly CRM. Returns project records with names, statuses, dates, and linked records. Use top/skip for pagination and status to filter by project state. |
insightly.insightly_get_current_user | Read | none | Get the profile of the currently authenticated Insightly user. Returns user name, email, account info, and timezone settings. Useful for verifying API connectivity. |
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.