Can I use Keap as a CLI?

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

Can I expose Keap through MCP?

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

Where are Keap credentials stored?

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

Can I deny write access for Keap MCP tools?

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

sales

Keap CLI for Headless Automation

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

7 functions 6 read 1 write Bearer token auth

Submit Keap feedback View package source

Keap 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 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 Headless Automation
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 --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 Keap CLI Pages

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