Skip to main content

​
Server URL

https://mcp.activitysmith.com/mcp

​
What Agents Can Do

Push Notifications

Send Push Notifications to your paired devices or targeted channels.

Live Activities

Start, update, and end Live Activities on your iPhone, like live task progress on your Lock Screen.

Lock Screen Widgets

Create widget metrics and update metric values for your Lock Screen Widgets.

Channels and History

List the history of your Push Notifications and Live Activities. List account users and devices, manage channels, and API keys.
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 once, and the ActivitySmith tools become available in new sessions.

​
Claude Code

claude mcp add --transport http activitysmith https://mcp.activitysmith.com/mcp
Then run /mcp inside a Claude Code session to go through the authentication flow.

​
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

​
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.

​
OAuth

ActivitySmith MCP uses OAuth. You do not need to create or paste an ActivitySmith API key into an agent prompt. During authorization, ActivitySmith shows the access requested by the client. Most clients request read and write access so the agent can inspect current state and then take action when you ask it to.

​
Example Prompts

Notify me on my iPhone when this is done.

Show me the progress visible on my Lock Screen with a Live Activity.

Send me a Push Notification if this task gets blocked.

​
Tools

The server exposes the following MCP tools, grouped by resource. Keep tool confirmation enabled in your client when possible, especially when you connect multiple MCP servers to the same agent session.
ResourceToolDescription
Push Notificationssend_push_notificationSend a Push Notification, with optional actions, media, and channel targeting.
Push Notificationslist_push_notificationsList Push Notification history for the account.
Push Notificationsget_push_notificationGet one Push Notification by public ID.
Live Activitiesset_live_activity_streamStart or update a managed Live Activity stream.
Live Activitiespause_live_activity_streamPause a stream and end its current Live Activity.
Live Activitiesresume_live_activity_streamResume a paused stream so updates apply again.
Live Activitiesend_live_activity_streamEnd the current Live Activity and remove the stream key.
Live Activitieslist_live_activitiesList Live Activities for the account.
Lock Screen Widgetscreate_widget_metricCreate a widget metric definition.
Lock Screen Widgetsset_widget_metric_valueSet the latest value for a widget metric.
Lock Screen Widgetsupdate_widget_metricUpdate a widget metric definition.
Lock Screen Widgetslist_widget_metricsList widget metrics for the account.
Lock Screen Widgetsdelete_widget_metricDelete a widget metric.
Channelscreate_channelCreate a channel for targeting Push Notifications and Live Activities.
Channelsget_channelGet one channel with its assigned users and devices.
Channelslist_channelsList channels for the account.
Channelsupdate_channelUpdate a channel slug.
Channelsset_channel_usersReplace the user membership for a channel.
Channelsset_channel_devicesReplace explicit device assignments for a channel.
Channelsdelete_channelDelete a channel.
Users and Deviceslist_account_usersList users in the account for channel assignment.
Users and Deviceslist_account_devicesList active devices for explicit channel assignment.
API Keyscreate_api_keyCreate an API key. The key secret is shown once.
API Keyslist_api_keysList API keys. Secret values are never returned.
API Keysupdate_api_keyUpdate the name or channel scope of an API key.
API Keysdelete_api_keyDelete an API key by public ID.