# Pushbullet MCP

> Pushbullet MCP Server: Control your cross-device workflow by syncing files, links, and notifications across all hardware. This server connects your AI client directly to Pushbullet's API, letting you manage notes, shared content, and system alerts from a single chat interface. Use it to send an address snippet instantly to your phone while keeping the link history visible in your development terminal.

## Overview
- **Category:** industry-titans
- **Price:** Free
- **Tags:** cross-device-sync, notifications, file-transfer, universal-clipboard, real-time-alerts

## Description

Forget copying and pasting stuff between your phone, laptop, and tablet. This server hooks up your AI client directly to Pushbullet's API so you can treat cross-device syncing like a simple chat command. You manage notes, links, and system alerts from one place—your development terminal or chat window. It's built for speed when you need data on multiple screens at once.

### **Getting Set Up**

First, y'gotta make sure the connection is solid. Use `test_pushbullet_auth` to verify your credentials and confirm that everything works right out of the gate. You can also run `get_api_status` to check the current server status of your Pushbullet account. When you’re ready to manage hardware, you gotta know what y'got connected; `list_connected_devices` gives you a rundown of every phone and computer linked to your account. If you grab a new gadget or need to ditch an old one, you can use `register_new_device` to add it to the network, or run `remove_device` if it's been retired.

### **Sending Stuff Everywhere**

The core function is sending data. With `send_push_notification`, your AI client pushes text, links, notes, addresses—whatever payload you give it—to one specific device, a group of devices, or even the whole connected network. Wanna send an alert to a specific coworker? You first use `list_push_contacts` to pull up their profile and user name, then you blast them with a message using the notification tool. This lets your agent act like it's sending direct system alerts straight into your contact list.

### **Managing Feeds and Channels**

You can keep your team in the loop on external stuff without ever opening a browser. Use `list_channel_subscriptions` to see which public feeds you're already tracking updates from. If y'all need to start monitoring another source, run `subscribe_to_channel` right there in chat. When that feed isn't relevant anymore, just use `unsubscribe_from_channel` to pull it off your monitored list.

### **Tracking and Cleanup**

Need to know who got what? You can audit past communication activity with `list_recent_pushes`, which pulls a history of all the push notifications sent across every device. If you ever gotta clean up old spam or sensitive data from that log, run `remove_push_record` and specify the historical record you want gone. To keep tabs on your network's status, you can also check out what channels you’re following by calling `list_channel_subscriptions`, ensuring y'all stay updated on relevant feeds without manual checks.

This whole setup lets you treat cross-device communication like a single conversation thread, making it way faster than jumping between apps.

## Tools

### get_api_status
Checks the server connection status of your Pushbullet account.

### list_channel_subscriptions
Retrieves a list of public channels you are currently following for updates.

### list_connected_devices
Displays all hardware devices linked to your Pushbullet account.

### list_push_contacts
Lists the contact profiles and user names in your network.

### list_recent_pushes
Retrieves a history of recently sent push notifications across all devices.

### register_new_device
Adds a new hardware device to your Pushbullet account so you can send it notifications.

### remove_device
Deletes a specific hardware device from your connected list.

### remove_push_record
Allows you to delete a specific, historical push record.

### send_push_notification
Sends data (links, text) to one or more specified devices in your network.

### subscribe_to_channel
Adds a public channel feed to your list of monitored channels.

### test_pushbullet_auth
Verifies that the connection and credentials provided are working correctly.

### unsubscribe_from_channel
Removes a followed channel from your subscription feed.

## Prompt Examples

**Prompt:** 
```
Push this link to my phone: https://vinkius.com
```

**Response:** 
```
Sending link... I've pushed 'https://vinkius.com' to your primary device via Pushbullet. Should I also send it to your computer?
```

**Prompt:** 
```
Send a push notification to all my devices with a reminder about the team meeting at 3 PM.
```

**Response:** 
```
Push notification sent to all 4 connected devices. Title: "Team Meeting Reminder". Body: "Team sync at 3:00 PM EST in Conference Room B. Agenda: Q2 review, sprint planning." Delivered to: MacBook Pro (instant), iPhone 15 (instant), iPad Air (instant), Windows Desktop (0.3s delay). All devices confirmed receipt. The notification was also mirrored to your Chrome browser extension.
```

**Prompt:** 
```
Share this URL across all my devices and send a copy to my colleague james@meridian.io.
```

**Response:** 
```
Link shared successfully. URL: https://docs.example.com/q2-report. Pushed to your 4 devices with preview: "Q2 Revenue Report - Interactive Dashboard". Copy sent to james@meridian.io via Pushbullet channel (delivered in 0.5s). James will see it on his connected devices. You can track if he opened it in your push history. The link was automatically saved to your clipboard on your active MacBook.
```

## Capabilities

### Send cross-device notifications
The AI pushes links, notes, addresses, or full text payloads to selected devices or all connected hardware.

### List and manage connected hardware
Retrieves a list of all associated devices (phones, computers, etc.) and allows the agent to create new device records.

### Send system alerts to contacts
The AI sends messages or files directly to specific contact profiles within your Pushbullet network.

### Track past communication activity
Retrieves a history of all recent pushes and system records, letting you audit who received what.

### Manage channel subscriptions
The AI allows you to list or follow specific public channels, ensuring your team stays updated on relevant feeds.

## Use Cases

### Sharing code between machine types
A developer writes a quick fix on their workstation but needs the mobile version for testing. Instead of zipping and emailing, they ask the agent: 'Push this file to my iPhone.' The agent runs `send_push_notification`, delivering the snippet immediately across the required hardware.

### Broadcasting a system outage alert
An Ops Engineer detects an issue and needs every member of the team (phones, desktops) to know right now. They command: 'Send high priority alert about database downtime.' The agent uses `send_push_notification` to hit all 15 connected devices instantly.

### Onboarding a new remote worker
A coordinator needs to ensure the new hire's device is recognized in the system. They run `list_connected_devices`, see the gap, and instruct the agent to use `register_new_device` with the new hardware profile.

### Monitoring team channels
A manager needs to ensure they don't miss important industry updates. They ask the agent to check channels: 'List my tech news subscriptions.' The agent executes `list_channel_subscriptions` and reports back on active feeds.

## Benefits

- Instantly share content: Stop manually switching between your laptop and phone. You can push a URL or a code snippet to every device with one command, using `send_push_notification`.
- Audit communications: Need to know if an alert went out? Use `list_recent_pushes` to get full history records, letting you track exactly what was sent and when.
- Manage hardware from chat: Don't waste time logging into the website. The AI can use `list_connected_devices` or `register_new_device` to update your device roster on the fly.
- Automate alerts: For Ops teams, you don't need complex scripting for simple broadcasts. Tell the agent to notify 10 people; it handles the multi-target delivery via `send_push_notification`.
- Centralize comms: You can use `list_push_contacts` and `send_push_notification` together. Send a specific message to a colleague without leaving your chat window.

## How It Works

The bottom line is: you manage device and file transfers without ever leaving your chat interface.

1. Subscribe to the server and provide your Pushbullet Access Token from your account settings.
2. Use natural language commands (e.g., 'Send this link to my iPad').
3. The AI client executes the necessary tool calls, sending data across all specified devices.

## Frequently Asked Questions

**How do I check if my credentials are working with Pushbullet MCP Server?**
Run the `test_pushbullet_auth` tool. This immediately verifies your token and connection status without needing to send any actual pushes or files.

**Can I add a new device using the Pushbullet MCP Server?**
Yep. Use the `register_new_device` tool. You just tell the agent what the hardware is, and it handles adding the profile to your account.

**What's the difference between listing devices and getting push history with Pushbullet MCP Server?**
Listing connected devices (`list_connected_devices`) shows *what* hardware you own. Getting recent pushes (`list_recent_pushes`) shows *what data* was sent to that hardware.

**Does the Pushbullet MCP Server let me send data to a specific contact?**
Yes, you can target individuals using `send_push_notification`. You just specify the recipient's name or ID when writing your prompt.

**What is the difference between using `list_channel_subscriptions` and `subscribe_to_channel` with Pushbullet MCP Server?**
Listing shows what you currently follow. To change your feed status, you must use `subscribe_to_channel`. This tool executes a state change, adding or removing a specific channel feed from your account.

**If I retire a device, how do I safely delete it using the `remove_device` tool in Pushbullet MCP Server?**
The `remove_device` tool permanently deletes the target hardware profile. You simply pass the device ID to the function; no manual confirmation is needed from your end.

**Can I delete old data using the `remove_push_record` tool in Pushbullet MCP Server?**
Yes, you can manually purge records. You must provide the unique push ID to this function. This deletes a specific notification entry from your history entirely.

**How do I stop receiving updates from a source using `unsubscribe_from_channel` with Pushbullet MCP Server?**
Running `unsubscribe_from_channel` immediately stops the feed. You pass the channel name or ID, and the server removes that stream of notifications from your active subscriptions.

**Can my AI automatically send a link to my phone from my computer?**
Yes! Use the `create_push` tool with type 'link'. Provide the URL and optionally a `device_iden` (or leave blank to push to all), and your agent will deliver the link instantly.

**How do I find the identifier (iden) for a specific device?**
Simply ask the agent to run the `list_devices` action. It will retrieve the full list of your associated phones, tablets, and browsers along with their unique `iden` codes.

**How do I find my Pushbullet Access Token?**
Log in to your Pushbullet account on the web, navigate to the [**Settings**](https://www.pushbullet.com/#settings) page, and click 'Create Access Token' under the Account section.