Give AI models and agents a direct line to your iPhone

SERVER URL

https://mcp.activitysmith.com/mcp

PROTOCOL

modelcontextprotocol.io

Overview

Connect the official ActivitySmith MCP server to Claude Code, Cursor, Codex, Grok, or any other client that supports remote MCP servers. After OAuth approval, your agent can send remote approvals and Push Notifications while showing real-time updates with Live Activities on your iPhone and iPad.

Remote approvals, handled end to end

Set a standing rule for actions that need your approval, such as making any purchase, deploying to production, publishing publicly, sending an external email, or deleting data. When an agent reaches that boundary, ActivitySmith stores its request and delivers two clearly labeled actions through a Live Activity or Push Notification.

When you choose an action, the waiting agent receives the decision immediately. Pending requests remain available for up to 30 minutes, giving you time to respond after stepping away.

See how remote approvals for AI agents work.

What agents can do

Push Notifications: Send Push Notifications to your paired devices.
Live Activities: Show real-time business metrics, operational state, or ongoing work on your Lock Screen.
Remote approvals: Send remote approvals that you can accept or reject from your iPhone.
Lock Screen widgets: Update values shown in your Lock Screen widgets.
App Icon Badge Count: Set or clear the App Icon Badge Count on paired devices.
History: Review Push Notification and Live Activity history.

AI agent task progress Live Activity on the iPhone Lock Screen, updated over MCP

Setup instructions

The server URL is the same in every client. Approve the OAuth screen in your browser to make the ActivitySmith tools available in new sessions.

Claude Code

1. Register the ActivitySmith MCP server

Open a terminal and run this command. User scope makes ActivitySmith available in Claude Code across all your projects.

claude mcp add --transport http --scope user activitysmith https://mcp.activitysmith.com/mcp

2. Open the MCP menu

Start a new Claude Code session, then run this command inside the session and select activitysmith.

/mcp

3. Approve access

In Claude Code, select Authenticate to open the authorization page. Sign in if prompted, review the requested access, then click Approve.

4. You're ready

Return to Claude Code. ActivitySmith tools are now available in your sessions across all projects.

Cursor

Install in Cursor with one click. If you prefer manual setup, add the server to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "activitysmith": {
      "url": "https://mcp.activitysmith.com/mcp"
    }
  }
}

Cursor prompts you to log in the first time the server is used.

Codex

codex mcp add activitysmith --url https://mcp.activitysmith.com/mcp

Then authenticate:

codex mcp login activitysmith

Grok

In Grok, open Connectors, select New Connector, then select Custom and enter the server URL:

https://mcp.activitysmith.com/mcp

Complete the OAuth flow in the pop-up window. If Safari blocks it, allow pop-up windows for grok.com and try again.

For Grok Build, add the server from a terminal:

grok mcp add --transport http activitysmith https://mcp.activitysmith.com/mcp

Other MCP clients

For any client that asks for a remote MCP server URL, use https://mcp.activitysmith.com/mcp. The authorization flow happens in ActivitySmith. After approval, tools run against the account you authorized.

Tools

The server exposes the following MCP tools, grouped by resource. We recommend keeping tool confirmation enabled in your client and exercising caution when combining the server with other MCP servers, to reduce the risk of prompt injection. API key administration remains in the ActivitySmith web app and is not exposed to MCP clients.

Resource	Tool	Description
Approvals	`request_approval`	Send an actionable approval request with optional action-specific button labels, then wait for the decision.
	`wait_for_approval`	Resume waiting for a pending approval and wake as soon as the user decides.
	`get_approval`	Get the current state of an approval request without waiting.
	`cancel_approval`	Cancel a pending approval request that is no longer needed.
	`request_approval_task`	Create a durable approval task in MCP clients that support MCP Tasks.
Push Notifications	`send_push_notification`	Send a Push Notification, with optional actions, media, and channel targeting.
	`list_push_notifications`	List Push Notification history for the account.
	`get_push_notification`	Get one Push Notification by public ID.
App Icon Badge Count	`update_app_icon_badge_count`	Set or clear the App Icon Badge Count, with optional channel targeting.
Live Activities	`set_live_activity_stream`	Start or update a managed Live Activity stream.
	`pause_live_activity_stream`	Pause a stream and end its current Live Activity.
	`resume_live_activity_stream`	Resume a paused stream so updates apply again.
	`end_live_activity_stream`	End the current Live Activity and remove the stream key.
	`list_live_activities`	List Live Activities for the account.
Tags	`list_tags`	List account-wide tags and their usage across Push Notifications and Live Activities.
Lock Screen Widgets	`create_widget_metric`	Create a widget metric definition.
	`set_widget_metric_value`	Set the latest value for a widget metric.
	`update_widget_metric`	Update a widget metric definition.
	`list_widget_metrics`	List widget metrics for the account.
	`delete_widget_metric`	Delete a widget metric.
Channels	`create_channel`	Create a channel for targeting Push Notifications and Live Activities.
	`get_channel`	Get one channel with its assigned users and devices.
	`list_channels`	List channels for the account.
	`update_channel`	Update a channel slug.
	`set_channel_users`	Replace the user membership for a channel.
	`set_channel_devices`	Replace explicit device assignments for a channel.
	`delete_channel`	Delete a channel.
Users and Devices	`list_account_users`	List users in the account for channel assignment.
Users and Devices	`list_account_devices`	List active devices for explicit channel assignment.

Ready to let your agents keep you posted?

Start your 7-day free trial. No credit card required.

Start Today Get a Demo