Can I use Pushbullet as a CLI?

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

Can I expose Pushbullet through MCP?

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

Where are Pushbullet credentials stored?

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

Can I deny write access for Pushbullet MCP tools?

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

productivity

Pushbullet CLI for AI Agents

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

Pushbullet CLI Setup

Pushbullet can be configured headlessly with `kosmokrator integrations:configure pushbullet`.

Install, configure, and verify

# 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 pushbullet --set access_token="$PUSHBULLET_ACCESS_TOKEN" --enable --read allow --write ask --json
kosmokrator integrations:doctor pushbullet --json
kosmokrator integrations:status --json

Credentials

Authentication type: API key api_key. Configure credentials once, then reuse the same stored profile from scripts, coding CLIs, Lua, and MCP.

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

Command Patterns

The generic command is stable across every integration. The provider shortcut is shorter for humans.

Generic CLI call

kosmo integrations:call pushbullet.pushbullet_get_current_user '{}' --json

Provider shortcut

kosmo integrations:pushbullet pushbullet_get_current_user '{}' --json

Discovery

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

Discovery commands

kosmo integrations:docs pushbullet --json
kosmo integrations:docs pushbullet.pushbullet_get_current_user --json
kosmo integrations:schema pushbullet.pushbullet_get_current_user --json
kosmo integrations:search "Pushbullet" --json
kosmo integrations:list --json

Automation Contexts

The same configured command surface works in these environments. The command does not change unless the host wrapper, credentials, or permissions change.

CI Run integration calls from CI jobs with JSON output, explicit credentials, and predictable exit status. Cron Jobs Schedule repeatable integration workflows from cron while keeping credentials in KosmoKrator config. Shell Scripts Call integration functions from shell scripts with stable JSON input and output. Headless Automation Use KosmoKrator as a non-interactive integration runtime for local automations and wrappers. Coding Agents Let coding agents discover schemas and execute integration functions through CLI commands or MCP.

CLI Functions

Every function below can be called headlessly. Commands are highlighted, copyable, and scroll horizontally when payloads are long.

`pushbullet.pushbullet_get_current_user`

Get the authenticated Pushbullet user's profile information, including name, email, and account details.

Read read

Parameters: none

Generic call

kosmo integrations:call pushbullet.pushbullet_get_current_user '{}' --json

Shortcut

kosmo integrations:pushbullet pushbullet_get_current_user '{}' --json

`pushbullet.pushbullet_list_pushes`

List recent pushes (notifications) from Pushbullet. Returns push items including notes, links, and files.

Read read

Parameters: limit, cursor, active, modified_after

Generic call

kosmo integrations:call pushbullet.pushbullet_list_pushes '{"limit":1,"cursor":"example_cursor","active":true,"modified_after":1}' --json

Shortcut

kosmo integrations:pushbullet pushbullet_list_pushes '{"limit":1,"cursor":"example_cursor","active":true,"modified_after":1}' --json

`pushbullet.pushbullet_create_push`

Send a Pushbullet push. Supports note, link, and file pushes.

Write write

Parameters: type, title, body, url, file_name, file_type, file_url, device_iden, email, channel_tag, client_iden

Generic call

kosmo integrations:call pushbullet.pushbullet_create_push '{"type":"example_type","title":"example_title","body":"example_body","url":"example_url","file_name":"example_file_name","file_type":"example_file_type","file_url":"example_file_url","device_iden":"example_device_iden"}' --json

Shortcut

kosmo integrations:pushbullet pushbullet_create_push '{"type":"example_type","title":"example_title","body":"example_body","url":"example_url","file_name":"example_file_name","file_type":"example_file_type","file_url":"example_file_url","device_iden":"example_device_iden"}' --json

`pushbullet.pushbullet_update_push`

Update an existing Pushbullet push, such as marking it dismissed.

Write write

Parameters: push_iden, dismissed

Generic call

kosmo integrations:call pushbullet.pushbullet_update_push '{"push_iden":"example_push_iden","dismissed":true}' --json

Shortcut

kosmo integrations:pushbullet pushbullet_update_push '{"push_iden":"example_push_iden","dismissed":true}' --json

`pushbullet.pushbullet_delete_push`

Delete a push notification from Pushbullet by its unique identifier (iden).

Write write

Parameters: push_iden

Generic call

kosmo integrations:call pushbullet.pushbullet_delete_push '{"push_iden":"example_push_iden"}' --json

Shortcut

kosmo integrations:pushbullet pushbullet_delete_push '{"push_iden":"example_push_iden"}' --json

`pushbullet.pushbullet_delete_all_pushes`

Delete all Pushbullet pushes for the authenticated user. This operation is asynchronous.

Write write

Parameters: none

Generic call

kosmo integrations:call pushbullet.pushbullet_delete_all_pushes '{}' --json

Shortcut

kosmo integrations:pushbullet pushbullet_delete_all_pushes '{}' --json

`pushbullet.pushbullet_list_devices`

List all devices registered with the current user's Pushbullet account. Returns device names, types, and identifiers.

Read read

Parameters: limit, cursor, active, modified_after

Generic call

kosmo integrations:call pushbullet.pushbullet_list_devices '{"limit":1,"cursor":"example_cursor","active":true,"modified_after":1}' --json

Shortcut

kosmo integrations:pushbullet pushbullet_list_devices '{"limit":1,"cursor":"example_cursor","active":true,"modified_after":1}' --json

`pushbullet.pushbullet_create_device`

Create a new Pushbullet device for the authenticated user.

Write write

Parameters: nickname, icon, model, manufacturer, push_token, app_version, has_sms

Generic call

kosmo integrations:call pushbullet.pushbullet_create_device '{"nickname":"example_nickname","icon":"example_icon","model":"example_model","manufacturer":"example_manufacturer","push_token":"example_push_token","app_version":1,"has_sms":true}' --json

Shortcut

kosmo integrations:pushbullet pushbullet_create_device '{"nickname":"example_nickname","icon":"example_icon","model":"example_model","manufacturer":"example_manufacturer","push_token":"example_push_token","app_version":1,"has_sms":true}' --json

`pushbullet.pushbullet_update_device`

Update a Pushbullet device such as nickname, icon, or SMS capability.

Write write

Parameters: device_iden, nickname, icon, model, manufacturer, push_token, app_version, has_sms

Generic call

kosmo integrations:call pushbullet.pushbullet_update_device '{"device_iden":"example_device_iden","nickname":"example_nickname","icon":"example_icon","model":"example_model","manufacturer":"example_manufacturer","push_token":"example_push_token","app_version":1,"has_sms":true}' --json

Shortcut

kosmo integrations:pushbullet pushbullet_update_device '{"device_iden":"example_device_iden","nickname":"example_nickname","icon":"example_icon","model":"example_model","manufacturer":"example_manufacturer","push_token":"example_push_token","app_version":1,"has_sms":true}' --json

`pushbullet.pushbullet_delete_device`

Delete a Pushbullet device by device iden.

Write write

Parameters: device_iden

Generic call

kosmo integrations:call pushbullet.pushbullet_delete_device '{"device_iden":"example_device_iden"}' --json

Shortcut

kosmo integrations:pushbullet pushbullet_delete_device '{"device_iden":"example_device_iden"}' --json

`pushbullet.pushbullet_list_chats`

List chats belonging to the authenticated Pushbullet user.

Read read

Parameters: limit, cursor, active, modified_after

Generic call

kosmo integrations:call pushbullet.pushbullet_list_chats '{"limit":1,"cursor":"example_cursor","active":true,"modified_after":1}' --json

Shortcut

kosmo integrations:pushbullet pushbullet_list_chats '{"limit":1,"cursor":"example_cursor","active":true,"modified_after":1}' --json

`pushbullet.pushbullet_create_chat`

Create a Pushbullet chat with another user or email address.

Write write

Parameters: email

Generic call

kosmo integrations:call pushbullet.pushbullet_create_chat '{"email":"example_email"}' --json

Shortcut

kosmo integrations:pushbullet pushbullet_create_chat '{"email":"example_email"}' --json

`pushbullet.pushbullet_update_chat`

Update a Pushbullet chat, usually to mute or unmute it.

Write write

Parameters: chat_iden, muted

Generic call

kosmo integrations:call pushbullet.pushbullet_update_chat '{"chat_iden":"example_chat_iden","muted":true}' --json

Shortcut

kosmo integrations:pushbullet pushbullet_update_chat '{"chat_iden":"example_chat_iden","muted":true}' --json

`pushbullet.pushbullet_delete_chat`

Delete a Pushbullet chat by chat iden.

Write write

Parameters: chat_iden

Generic call

kosmo integrations:call pushbullet.pushbullet_delete_chat '{"chat_iden":"example_chat_iden"}' --json

Shortcut

kosmo integrations:pushbullet pushbullet_delete_chat '{"chat_iden":"example_chat_iden"}' --json

`pushbullet.pushbullet_list_subscriptions`

List channel subscriptions belonging to the authenticated Pushbullet user.

Read read

Parameters: limit, cursor, active, modified_after

Generic call

kosmo integrations:call pushbullet.pushbullet_list_subscriptions '{"limit":1,"cursor":"example_cursor","active":true,"modified_after":1}' --json

Shortcut

kosmo integrations:pushbullet pushbullet_list_subscriptions '{"limit":1,"cursor":"example_cursor","active":true,"modified_after":1}' --json

`pushbullet.pushbullet_create_subscription`

Subscribe the authenticated Pushbullet user to a channel by tag.

Write write

Parameters: channel_tag

Generic call

kosmo integrations:call pushbullet.pushbullet_create_subscription '{"channel_tag":"example_channel_tag"}' --json

Shortcut

kosmo integrations:pushbullet pushbullet_create_subscription '{"channel_tag":"example_channel_tag"}' --json

`pushbullet.pushbullet_update_subscription`

Update a Pushbullet channel subscription, usually to mute or unmute it.

Write write

Parameters: subscription_iden, muted

Generic call

kosmo integrations:call pushbullet.pushbullet_update_subscription '{"subscription_iden":"example_subscription_iden","muted":true}' --json

Shortcut

kosmo integrations:pushbullet pushbullet_update_subscription '{"subscription_iden":"example_subscription_iden","muted":true}' --json

`pushbullet.pushbullet_delete_subscription`

Delete a Pushbullet channel subscription by subscription iden.

Write write

Parameters: subscription_iden

Generic call

kosmo integrations:call pushbullet.pushbullet_delete_subscription '{"subscription_iden":"example_subscription_iden"}' --json

Shortcut

kosmo integrations:pushbullet pushbullet_delete_subscription '{"subscription_iden":"example_subscription_iden"}' --json

`pushbullet.pushbullet_get_channel_info`

Get public information for a Pushbullet channel by tag.

Read read

Parameters: tag, no_recent_pushes

Generic call

kosmo integrations:call pushbullet.pushbullet_get_channel_info '{"tag":"example_tag","no_recent_pushes":true}' --json

Shortcut

kosmo integrations:pushbullet pushbullet_get_channel_info '{"tag":"example_tag","no_recent_pushes":true}' --json

`pushbullet.pushbullet_create_channel`

Create a Pushbullet channel with a globally unique tag.

Write write

Parameters: tag, name, description, image_url, website_url, feed_url, feed_filters

Generic call

kosmo integrations:call pushbullet.pushbullet_create_channel '{"tag":"example_tag","name":"example_name","description":"example_description","image_url":"example_image_url","website_url":"example_website_url","feed_url":"example_feed_url","feed_filters":"example_feed_filters"}' --json

Shortcut

kosmo integrations:pushbullet pushbullet_create_channel '{"tag":"example_tag","name":"example_name","description":"example_description","image_url":"example_image_url","website_url":"example_website_url","feed_url":"example_feed_url","feed_filters":"example_feed_filters"}' --json

`pushbullet.pushbullet_push_ephemeral`

Send a Pushbullet ephemeral event such as a clip or notification dismissal.

Write write

Parameters: type, push

Generic call

kosmo integrations:call pushbullet.pushbullet_push_ephemeral '{"type":"example_type","push":"example_push"}' --json

Shortcut

kosmo integrations:pushbullet pushbullet_push_ephemeral '{"type":"example_type","push":"example_push"}' --json

`pushbullet.pushbullet_request_upload`

Request a Pushbullet upload URL for a file push.

Write write

Parameters: file_name, file_type

Generic call

kosmo integrations:call pushbullet.pushbullet_request_upload '{"file_name":"example_file_name","file_type":"example_file_type"}' --json

Shortcut

kosmo integrations:pushbullet pushbullet_request_upload '{"file_name":"example_file_name","file_type":"example_file_type"}' --json

Function Schemas

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

pushbullet.pushbullet_get_current_user 0 parameters

Schema command

kosmo integrations:schema pushbullet.pushbullet_get_current_user --json

Parameter	Type	Required	Description
No parameters.

pushbullet.pushbullet_list_pushes 4 parameters

Schema command

kosmo integrations:schema pushbullet.pushbullet_list_pushes --json

Parameter	Type	Required	Description
`limit`	integer	no	Maximum number of pushes to return (default: 10, max: 500).
`cursor`	string	no	Pagination cursor from a previous response to get the next page of results.
`active`	boolean	no	Set true to exclude deleted pushes.
`modified_after`	number	no	Return pushes modified after this Unix timestamp.

pushbullet.pushbullet_create_push 11 parameters

Schema command

kosmo integrations:schema pushbullet.pushbullet_create_push --json

Parameter	Type	Required	Description
`type`	string	yes	Push type: "note", "link", or "file".
`title`	string	yes	The title of the push notification.
`body`	string	yes	The body text of the push notification.
`url`	string	no	Required for "link" type — the URL to include in the push.
`file_name`	string	no	Required for "file" type — name returned by upload-request.
`file_type`	string	no	Required for "file" type — MIME type returned by upload-request.
`file_url`	string	no	Required for "file" type — URL returned by upload-request after upload.
`device_iden`	string	no	Target a specific device by its iden. Omit to send to all devices.
`email`	string	no	Send to this email address.
`channel_tag`	string	no	Send to subscribers of this channel tag.
`client_iden`	string	no	Optional client identifier for idempotency.

pushbullet.pushbullet_update_push 2 parameters

Schema command

kosmo integrations:schema pushbullet.pushbullet_update_push --json

Parameter	Type	Required	Description
`push_iden`	string	yes	Push iden to update.
`dismissed`	boolean	no	Whether the push is dismissed.

pushbullet.pushbullet_delete_push 1 parameters

Schema command

kosmo integrations:schema pushbullet.pushbullet_delete_push --json

Parameter	Type	Required	Description
`push_iden`	string	yes	The unique identifier (iden) of the push to delete.

pushbullet.pushbullet_delete_all_pushes 0 parameters

Schema command

kosmo integrations:schema pushbullet.pushbullet_delete_all_pushes --json

Parameter	Type	Required	Description
No parameters.

pushbullet.pushbullet_list_devices 4 parameters

Schema command

kosmo integrations:schema pushbullet.pushbullet_list_devices --json

Parameter	Type	Required	Description
`limit`	integer	no	Maximum number of devices to return.
`cursor`	string	no	Pagination cursor from a previous response.
`active`	boolean	no	Set true to exclude deleted devices.
`modified_after`	number	no	Return devices modified after this Unix timestamp.

pushbullet.pushbullet_create_device 7 parameters

Schema command

kosmo integrations:schema pushbullet.pushbullet_create_device --json

Parameter	Type	Required	Description
`nickname`	string	yes	Name to display for the device.
`icon`	string	no	Device icon such as desktop, browser, laptop, tablet, phone, watch, or system.
`model`	string	no	Device model.
`manufacturer`	string	no	Device manufacturer.
`push_token`	string	no	Platform-specific push token.
`app_version`	integer	no	Pushbullet app version.
`has_sms`	boolean	no	Whether the device has SMS capability.

pushbullet.pushbullet_update_device 8 parameters

Schema command

kosmo integrations:schema pushbullet.pushbullet_update_device --json

Parameter	Type	Required	Description
`device_iden`	string	yes	Device iden to update.
`nickname`	string	no	Updated device nickname.
`icon`	string	no	Updated device icon.
`model`	string	no	Updated model.
`manufacturer`	string	no	Updated manufacturer.
`push_token`	string	no	Updated push token.
`app_version`	integer	no	Updated app version.
`has_sms`	boolean	no	Updated SMS capability.

pushbullet.pushbullet_delete_device 1 parameters

Schema command

kosmo integrations:schema pushbullet.pushbullet_delete_device --json

Parameter	Type	Required	Description
`device_iden`	string	yes	Device iden to delete.

pushbullet.pushbullet_list_chats 4 parameters

Schema command

kosmo integrations:schema pushbullet.pushbullet_list_chats --json

Parameter	Type	Required	Description
`limit`	integer	no	Maximum number of chats to return.
`cursor`	string	no	Pagination cursor.
`active`	boolean	no	Set true to exclude deleted chats.
`modified_after`	number	no	Return chats modified after this Unix timestamp.

pushbullet.pushbullet_create_chat 1 parameters

Schema command

kosmo integrations:schema pushbullet.pushbullet_create_chat --json

Parameter	Type	Required	Description
`email`	string	yes	Email address to create a chat with.

pushbullet.pushbullet_update_chat 2 parameters

Schema command

kosmo integrations:schema pushbullet.pushbullet_update_chat --json

Parameter	Type	Required	Description
`chat_iden`	string	yes	Chat iden to update.
`muted`	boolean	yes	Whether to mute the chat.

pushbullet.pushbullet_delete_chat 1 parameters

Schema command

kosmo integrations:schema pushbullet.pushbullet_delete_chat --json

Parameter	Type	Required	Description
`chat_iden`	string	yes	Chat iden to delete.

pushbullet.pushbullet_list_subscriptions 4 parameters

Schema command

kosmo integrations:schema pushbullet.pushbullet_list_subscriptions --json

Parameter	Type	Required	Description
`limit`	integer	no	Maximum number of subscriptions to return.
`cursor`	string	no	Pagination cursor.
`active`	boolean	no	Set true to exclude deleted subscriptions.
`modified_after`	number	no	Return subscriptions modified after this Unix timestamp.

pushbullet.pushbullet_create_subscription 1 parameters

Schema command

kosmo integrations:schema pushbullet.pushbullet_create_subscription --json

Parameter	Type	Required	Description
`channel_tag`	string	yes	Channel tag to subscribe to.

pushbullet.pushbullet_update_subscription 2 parameters

Schema command

kosmo integrations:schema pushbullet.pushbullet_update_subscription --json

Parameter	Type	Required	Description
`subscription_iden`	string	yes	Subscription iden to update.
`muted`	boolean	yes	Whether to mute the subscription.

pushbullet.pushbullet_delete_subscription 1 parameters

Schema command

kosmo integrations:schema pushbullet.pushbullet_delete_subscription --json

Parameter	Type	Required	Description
`subscription_iden`	string	yes	Subscription iden to delete.

pushbullet.pushbullet_get_channel_info 2 parameters

Schema command

kosmo integrations:schema pushbullet.pushbullet_get_channel_info --json

Parameter	Type	Required	Description
`tag`	string	yes	Channel tag.
`no_recent_pushes`	boolean	no	Set true to omit recent pushes from the response.

pushbullet.pushbullet_create_channel 7 parameters

Schema command

kosmo integrations:schema pushbullet.pushbullet_create_channel --json

Parameter	Type	Required	Description
`tag`	string	yes	Globally unique channel tag.
`name`	string	yes	Channel display name.
`description`	string	yes	Channel description.
`image_url`	string	no	Image URL for the channel.
`website_url`	string	no	Website URL for the channel.
`feed_url`	string	no	RSS feed URL to post automatically.
`feed_filters`	array	no	Optional RSS feed filters.

pushbullet.pushbullet_push_ephemeral 2 parameters

Schema command

kosmo integrations:schema pushbullet.pushbullet_push_ephemeral --json

Parameter	Type	Required	Description
`type`	string	yes	Outer ephemeral type, usually "push".
`push`	object	yes	Ephemeral push payload.

pushbullet.pushbullet_request_upload 2 parameters

Schema command

kosmo integrations:schema pushbullet.pushbullet_request_upload --json

Parameter	Type	Required	Description
`file_name`	string	yes	Name of the file to upload.
`file_type`	string	yes	MIME type of the file.

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.