Can I use Missive as a CLI?

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

Can I expose Missive through MCP?

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

Where are Missive credentials stored?

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

Can I deny write access for Missive MCP tools?

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

communication

Missive CLI for AI Agents

Use the Missive CLI from KosmoKrator to call Missive tools headlessly, return JSON, inspect schemas, and automate workflows from coding agents, scripts, and CI.

6 functions 4 read 2 write Bearer token auth

Submit Missive feedback View package source

Missive CLI Setup

Missive can be configured headlessly with `kosmokrator integrations:configure missive`.

# Install KosmoKrator first if it is not available on PATH.
curl -fsSL https://raw.githubusercontent.com/OpenCompanyApp/kosmokrator/main/install.sh | bash

# Configure and verify this integration.
kosmokrator integrations:configure missive --set access_token="$MISSIVE_ACCESS_TOKEN" --enable --read allow --write ask --json
kosmokrator integrations:doctor missive --json
kosmokrator integrations:status --json

Credentials

Authentication type: Bearer token bearer_token. Configure credentials once, then use the same stored profile from scripts, coding CLIs, Lua code mode, and the MCP gateway.

Key	Env var	Type	Required	Label
`access_token`	`MISSIVE_ACCESS_TOKEN`	Secret `secret`	yes	Access Token
`url`	`MISSIVE_URL`	URL `url`	no	API Base URL

Call Missive Headlessly

Use the generic call form when another coding CLI or script needs a stable universal interface.

kosmo integrations:call missive.missive_list_conversations '{
  "inbox": "example_inbox",
  "assignee": "example_assignee",
  "state": "example_state",
  "limit": 1,
  "offset": 1
}' --json

Use the provider shortcut form for shorter human-facing commands.

kosmo integrations:missive missive_list_conversations '{
  "inbox": "example_inbox",
  "assignee": "example_assignee",
  "state": "example_state",
  "limit": 1,
  "offset": 1
}' --json

Agent Discovery Commands

These commands return structured output for coding agents that need to inspect capabilities before choosing a function.

kosmo integrations:docs missive --json
kosmo integrations:docs missive.missive_list_conversations --json
kosmo integrations:schema missive.missive_list_conversations --json
kosmo integrations:search "Missive" --json
kosmo integrations:list --json

All CLI Functions

Every function below can be called headlessly. The generic form is stable across all integrations; the provider shortcut is shorter but specific to Missive.

`missive.missive_list_conversations`

Read read

List conversations from Missive. Supports filtering by inbox, assignee, and state. Returns paginated results.

Parameters: inbox, assignee, state, limit, offset

Generic CLI call

kosmo integrations:call missive.missive_list_conversations '{"inbox":"example_inbox","assignee":"example_assignee","state":"example_state","limit":1,"offset":1}' --json

Provider shortcut

kosmo integrations:missive missive_list_conversations '{"inbox":"example_inbox","assignee":"example_assignee","state":"example_state","limit":1,"offset":1}' --json

`missive.missive_get_conversation`

Read read

Get a single Missive conversation by ID, including messages and metadata.

Parameters: id

Generic CLI call

kosmo integrations:call missive.missive_get_conversation '{"id":"example_id"}' --json

Provider shortcut

kosmo integrations:missive missive_get_conversation '{"id":"example_id"}' --json

`missive.missive_create_comment`

Write write

Create a comment on a Missive conversation. Use this to add internal notes or replies.

Parameters: conversation_id, body, assignees

Generic CLI call

kosmo integrations:call missive.missive_create_comment '{"conversation_id":"example_conversation_id","body":"example_body","assignees":"example_assignees"}' --json

Provider shortcut

kosmo integrations:missive missive_create_comment '{"conversation_id":"example_conversation_id","body":"example_body","assignees":"example_assignees"}' --json

`missive.missive_list_tasks`

Read read

List tasks from Missive. Supports filtering by state and assignee. Returns paginated results.

Parameters: state, assignee, limit, offset

Generic CLI call

kosmo integrations:call missive.missive_list_tasks '{"state":"example_state","assignee":"example_assignee","limit":1,"offset":1}' --json

Provider shortcut

kosmo integrations:missive missive_list_tasks '{"state":"example_state","assignee":"example_assignee","limit":1,"offset":1}' --json

`missive.missive_create_task`

Write write

Create a new task in Missive. Requires a title. Optionally set description, assignee, and due date.

Parameters: title, description, assignee, due_date

Generic CLI call

kosmo integrations:call missive.missive_create_task '{"title":"example_title","description":"example_description","assignee":"example_assignee","due_date":"example_due_date"}' --json

Provider shortcut

kosmo integrations:missive missive_create_task '{"title":"example_title","description":"example_description","assignee":"example_assignee","due_date":"example_due_date"}' --json

`missive.missive_get_current_user`

Read read

Get the profile of the currently authenticated Missive user, including name, email, and organization info.

Parameters: none

Generic CLI call

kosmo integrations:call missive.missive_get_current_user '{}' --json

Provider shortcut

kosmo integrations:missive missive_get_current_user '{}' --json

Function Schemas

Use these parameter tables when building CLI payloads without calling integrations:schema first.

`missive.missive_list_conversations`

List conversations from Missive. Supports filtering by inbox, assignee, and state. Returns paginated results.

Operation: Read read
Schema command: kosmo integrations:schema missive.missive_list_conversations --json

Parameter	Type	Required	Description
`inbox`	string	no	Filter by inbox ID.
`assignee`	string	no	Filter by assignee user ID or email.
`state`	string	no	Filter by conversation state: "open", "closed", or "spam".
`limit`	integer	no	Maximum number of conversations to return (default: 25, max: 100).
`offset`	integer	no	Offset for pagination.

`missive.missive_get_conversation`

Get a single Missive conversation by ID, including messages and metadata.

Operation: Read read
Schema command: kosmo integrations:schema missive.missive_get_conversation --json

Parameter	Type	Required	Description
`id`	string	yes	The conversation UUID.

`missive.missive_create_comment`

Create a comment on a Missive conversation. Use this to add internal notes or replies.

Operation: Write write
Schema command: kosmo integrations:schema missive.missive_create_comment --json

Parameter	Type	Required	Description
`conversation_id`	string	yes	The UUID of the conversation to comment on.
`body`	string	yes	The comment body text. Supports Markdown.
`assignees`	array	no	List of user IDs or emails to assign the comment to.

`missive.missive_list_tasks`

List tasks from Missive. Supports filtering by state and assignee. Returns paginated results.

Operation: Read read
Schema command: kosmo integrations:schema missive.missive_list_tasks --json

Parameter	Type	Required	Description
`state`	string	no	Filter by task state: "open" or "completed".
`assignee`	string	no	Filter by assignee user ID or email.
`limit`	integer	no	Maximum number of tasks to return (default: 25, max: 100).
`offset`	integer	no	Offset for pagination.

`missive.missive_create_task`

Create a new task in Missive. Requires a title. Optionally set description, assignee, and due date.

Operation: Write write
Schema command: kosmo integrations:schema missive.missive_create_task --json

Parameter	Type	Required	Description
`title`	string	yes	The task title.
`description`	string	no	Detailed description of the task. Supports Markdown.
`assignee`	string	no	User ID or email of the person to assign the task to.
`due_date`	string	no	Due date in ISO 8601 format (e.g., "2025-12-31").

`missive.missive_get_current_user`

Get the profile of the currently authenticated Missive user, including name, email, and organization info.

Operation: Read read
Schema command: kosmo integrations:schema missive.missive_get_current_user --json

Parameter	Type	Required	Description
No parameters.

Permissions

Headless calls still follow the integration read/write permission policy. Configure read/write defaults with integrations:configure. Add --force only for trusted automation that should bypass that policy.