# Pushbullet — how to use (mcp.ai)

Pushbullet enables seamless sharing of notifications and files across devices.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_pushbullet?ms=1781542020000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `pushbullet_create_chat`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/pushbullet`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/pushbullet/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/pushbullet/create/chat` — Tool to create a new chat with the specified email address. use when you need to initiate a conversation thread by email.
  - body: { email: string }
- `POST https://api.mcp.ai/api/pushbullet/create/device` — Tool to register a new device under the current user's account. use when adding a new hardware or app device to pushbullet.
  - body: { icon?: string, model: string, has_sms?: boolean, nickname: string, push_token?: string, app_version: integer, manufacturer: string }
- `POST https://api.mcp.ai/api/pushbullet/create/push` — Tool to send a new push (note, link, or file) to a device, user, channel, or client. use when you need to share content to a specific target. example: "send a link to https://example.com to device abc
  - body: { url?: string, body?: string, guid?: string, type: string, email: string, title?: string, file_url?: string, file_name?: string, file_type?: string, channel_tag?: string, client_iden?: string, device_iden?: string, source_device_iden?: string }
- `POST https://api.mcp.ai/api/pushbullet/delete/all/pushes` — Tool to delete all pushes for the current user asynchronously. use when you need to bulk-clear all existing pushes in one call.
- `POST https://api.mcp.ai/api/pushbullet/delete/chat` — Tool to delete a chat by its identifier. use when you need to remove a chat from your pushbullet account after confirming its identifier.
  - body: { iden: string }
- `POST https://api.mcp.ai/api/pushbullet/delete/device` — Tool to remove a device by its identifier. use when you need to delete a device from your pushbullet account after confirming its identifier.
  - body: { device_iden: string }
- `POST https://api.mcp.ai/api/pushbullet/delete/push` — Tool to delete a specific push by its identifier. use when you need to remove a push after confirming its identifier.
  - body: { iden: string }
- `POST https://api.mcp.ai/api/pushbullet/get/user` — Tool to retrieve the currently authenticated user's profile. use when you need to verify the access token or display the current user's details.
- `POST https://api.mcp.ai/api/pushbullet/list/chats` — Tool to list all chat objects for the current user. use when you need the full set of chat threads before sending or muting messages.
- `POST https://api.mcp.ai/api/pushbullet/list/devices` — Tool to list all registered devices for the current user. use after obtaining a valid access token.
- `POST https://api.mcp.ai/api/pushbullet/list/pushes` — Tool to list pushes with optional filtering and pagination. use when retrieving or syncing pushes after a certain time.
  - body: { limit?: integer, active?: boolean, cursor?: string, modified_after?: number }
- `POST https://api.mcp.ai/api/pushbullet/pushbullet/create/device` — Tool to register a new device under the current user’s account. use when adding a new hardware or app device to the user's pushbullet devices.
  - body: { icon?: string, model: string, has_sms?: boolean, nickname: string, push_token?: string, app_version: integer, manufacturer: string }
- `POST https://api.mcp.ai/api/pushbullet/pushbullet/delete/all/pushes` — Tool to delete all pushes for the current user asynchronously. use when you need to bulk-clear all existing pushes in one call.
- `POST https://api.mcp.ai/api/pushbullet/pushbullet/delete/push` — Tool to delete a specific push by its identifier. use when you need to remove a push you created.
  - body: { iden: string }
- `POST https://api.mcp.ai/api/pushbullet/pushbullet/update/chat` — Tool to mute or unmute an existing chat. use when adjusting notification settings for a specific chat by its identifier.
  - body: { iden: string, muted: boolean }
- `POST https://api.mcp.ai/api/pushbullet/pushbullet/update/device` — Tool to update metadata for a device by its identifier. use when you need to change device settings like nickname, model, or icon.
  - body: { icon?: string, iden: string, model?: string, has_sms?: boolean, nickname?: string, push_token?: string, app_version?: integer, manufacturer?: string }
- `POST https://api.mcp.ai/api/pushbullet/update/device` — Tool to update metadata for a device by its identifier. use when changing a device's nickname, model, or other settings.
  - body: { icon?: string, iden: string, model?: string, has_sms?: boolean, nickname?: string, push_token?: string, app_version?: integer, manufacturer?: string }
- `POST https://api.mcp.ai/api/pushbullet/update/push` — Tool to update a push (dismiss or modify list items) by its identifier. use when marking a push as dismissed or updating list push items.
  - body: { iden: string, items?: object[], dismissed?: boolean }
- `POST https://api.mcp.ai/api/pushbullet/upload/request` — Tool to obtain a signed upload url for a file before pushing. use when you need to upload file content via the signed s3 form data.
  - body: { file_name: string, file_type: string }

## More
- Page: https://mcp.ai/pushbullet
- Agent spec (llms.txt): https://mcp.ai/pushbullet/llms.txt
- Postman collection: https://mcp.ai/pushbullet/postman.json