How to integrate Pushover MCP with Atomic Agent

Connect Atomic Agent to Pushover MCP. Send device alert for server downtime, notify me of new support tickets, and more using natural language, with authentication handled for you.

Pushover logoPushover
Api Key

Pushover is a real-time notification service that sends messages to your devices via a simple API. It's perfect for instant alerts and staying on top of important events wherever you are.

29 Tools

Introduction

Atomic Agent is an open-source AI agent that runs on your machine and supports local models through llama.cpp. Connect it to 1,500+ apps through Composio, including Pushover.

This guide uses Atomic Agent's built-in Composio integration. You need Atomic Agent v0.5.6 or later, your own Composio API key, and a Pushover account. See the Atomic Agent documentation for installation instructions.

Also integrate Pushover with

How Atomic Agent connects to Pushover

Atomic Agent connects to Composio's Tool Router over Streamable HTTP MCP. It discovers the tools needed for your request, and Composio handles account authentication.

Execution and account-connection tools follow Atomic Agent's configured approval policy. Review any approval prompt before allowing an action on your connected account.

Connect Pushover to Atomic Agent

  1. Sign up or sign in to the Composio dashboard. Copy your API key.
  2. In Atomic Agent, open the Integrations tab and select Composio. Select API key, press e, paste the key, and press Enter. The tools become available immediately, without a restart.
  3. Ask Atomic Agent to do something in Pushover. It searches Composio for the right tool.
  4. On first use, open the sign-in link returned in the chat. Connect your Pushover account, then return to Atomic Agent to continue.

Headless setup

Add the following line to ~/.atomic-agent/.env, replacing YOUR_COMPOSIO_API_KEY with your key. Start Atomic Agent after saving the file.

bash
COMPOSIO_API_KEY=YOUR_COMPOSIO_API_KEY

What is the Pushover MCP server, and what's possible with it?

The Pushover MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Pushover account. It provides structured and secure access to your notification system, so your agent can send instant alerts, deliver custom messages, manage notification priorities, and automate device notifications on your behalf.

  • Instant push notifications: Have your agent send real-time alerts to your devices for important events, tasks, or reminders.
  • Custom message delivery: Allow your agent to craft and deliver personalized notifications with specific titles, messages, and sounds.
  • Priority and sound control: Let the agent set notification priority levels and choose custom sounds to ensure the right alerts stand out.
  • Device targeting: Direct your agent to send notifications to specific devices or user groups for tailored communication.
  • Automated workflow integration: Seamlessly trigger Pushover alerts from other automated tasks or events managed by your agent, keeping you informed in real-time.

Use Pushover from Atomic Agent

With your account connected, ask Atomic Agent to work with Pushover in natural language. You can connect more apps through the same Composio integration as you need them.

Visit the Atomic Agent website or inspect the Atomic Agent source code.

Troubleshooting

Why is my API key rejected?

Copy the key directly from the Composio dashboard. Atomic Agent requires ASCII characters because it sends the key in an HTTP header. Remove any extra characters introduced when copying.

Why are Composio tools unavailable after saving a key?

Check that you use Atomic Agent v0.5.6 or later and that Composio is enabled in your configuration. A "composio": { "enabled": false } setting disables the integration while keeping the saved key on disk.

Does Composio have a free plan?

The Hobby plan includes 100,000 tool calls per month. Composio-managed OAuth apps have a lower included allowance. See Composio pricing for the current limits that apply to your connection.

TOOLS

Supported Tools

Every Pushover action and event your agent gets out of the box.

Cancel Receipt Retries

Tool to cancel further retries for an emergency-priority message before its expiry.

Cancel Retries by Tag

Tool to cancel retries for all active emergency-priority Pushover messages matching a specific tag.

Client Acknowledge Delete Up To ID

Tool to delete/acknowledge device messages up to a specific message ID.

Fetch Pending Messages

Tool to download pending messages for a registered device.

Pushover Client Login

Tool to authenticate a Pushover user by email and password.

Client Realtime WebSocket Connection

Tool to establish a secure WebSocket connection for real-time message notifications.

Register Open Client Device

Tool to register an Open Client desktop device.

Get Application Icon Image

Tool to fetch an application icon PNG by icon identifier.

Get App Limits

Tool to retrieve the current monthly message limit, remaining messages, and reset time for a Pushover application.

Get Application Token

Tool to fetch stored Pushover application API token.

Get Receipt Status

Tool to poll the status of an emergency-priority notification receipt.

Get Team API Token

Tool to fetch stored Pushover for Teams API token.

Glances Update

Tool to update a user's Glances widget data without sending a notification.

Add User to Group

Tool to add an existing Pushover user to a delivery group.

Create Group

Tool to create a new Delivery Group.

Disable Group User

Tool to temporarily disable deliveries to a user or specific device within a Pushover group.

Group Enable User

Tool to re-enable deliveries to a previously disabled user (or specific device) within a Pushover group.

Get Group Details

Tool to retrieve details for a Delivery Group.

List Delivery Groups

Tool to list all Delivery Groups.

Remove User from Group

Tool to remove a user (or optionally a specific device) from a Pushover delivery group.

Rename Delivery Group

Tool to rename an existing Delivery Group.

Assign License

Tool to assign a pre-paid license credit to a Pushover user by key or email.

Check License Credits

Tool to retrieve remaining license credits for a Pushover application.

Send Message

Tool to send a push notification with optional title, URL, priority, sound, attachments, and filters.

Store Team API Token

Tool to securely store a Pushover for Teams API token.

Subscription Flow

Tool to validate and return a Pushover subscription code.

Add Team User

Tool to add a user to a Pushover for Teams organization.

Remove User from Team

Tool to remove a user from a Pushover for Teams organization.

Validate User or Group

Tool to validate a Pushover user or group key for deliverability.

FAQ

Frequently asked questions

With a standalone Pushover MCP server, the agents and LLMs can only access a fixed set of Pushover tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from Pushover and many other apps based on the task at hand, all through a single MCP endpoint.

Yes, you can. Atomic Agent fully supports MCP integration. You get structured tool calling, message history handling, and model orchestration while Tool Router takes care of discovering and serving the right Pushover tools.

Yes, absolutely. You can configure which Pushover scopes and actions are allowed when connecting your account to Composio. You can also bring your own OAuth credentials or API configuration so you keep full control over what the agent can do.

All sensitive data such as tokens, keys, and configuration is fully encrypted at rest and in transit. Composio is SOC 2 Type 2 compliant and follows strict security practices so your Pushover data and credentials are handled as safely as possible.

Start with Pushover.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Pushover tool your agent needs.Free to start.

Start building