sales
Keap CLI for Shell Scripts
Use the Keap CLI for shell scripts with headless JSON commands, schema discovery, credentials, and permission controls.
7 functions 6 read 1 write Bearer token auth
Keap 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 Keap CLI uses the same integration registry as the TUI, Lua runtime, and MCP gateway, but returns predictable command output for automation.
Command Shape
# Keap CLI for Shell Scripts
kosmokrator integrations:configure keap --set access_token="$KEAP_ACCESS_TOKEN" --enable --read allow --write ask --json
kosmo integrations:call keap.keap_list_contacts '{"page":1,"limit":1}' --json Discovery Before Execution
Agents and scripts can inspect Keap docs and schemas before choosing a function.
kosmo integrations:docs keap --json
kosmo integrations:docs keap.keap_list_contacts --json
kosmo integrations:schema keap.keap_list_contacts --json
kosmo integrations:search "Keap" --json
kosmo integrations:list --json Useful Keap CLI Functions
| Function | Type | Parameters | Description |
|---|---|---|---|
keap.keap_list_contacts | Read | page, limit | List contacts from Keap CRM. Returns paginated results with contact details including name, email, and company. |
keap.keap_get_contact | Read | id | Retrieve a single Keap contact by ID. Returns full contact details including email addresses, phone numbers, and tags. |
keap.keap_create_contact | Write | first_name, last_name, email, company_name | Create a new contact in Keap CRM. Provide at least a first name or last name. Email and company name are optional. |
keap.keap_list_opportunities | Read | page, limit, stage | List sales opportunities from Keap CRM. Optionally filter by pipeline stage. Returns paginated results with opportunity details. |
keap.keap_get_opportunity | Read | id | Retrieve a single Keap sales opportunity by ID. Returns full details including contact, stage, value, and notes. |
keap.keap_list_tags | Read | none | List all tags in Keap. Tags are used to categorize contacts and trigger automations. |
keap.keap_get_current_user | Read | none | Get the currently authenticated Keap user. Returns profile information for the user associated with the access token. |
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.