{"slug":"macos-and-ios-shortcuts","title":"macOS and iOS shortcuts","tags":["tailscale"],"agent_summary":"Last validated: Jan 5, 2026","trigger_phrases":[],"runnable":false,"markdown":"\r\n# macOS and iOS shortcuts\r\n\r\nLast validated: Jan 5, 2026\r\n\r\nTailscale works with the Shortcuts app on macOS and iOS to provide several built-in shortcut actions, allowing you to automate tasks. For example, you can create shortcuts to connect your device to a tailnet, use an exit node, or switch user accounts.\r\n\r\nYou can combine the Tailscale actions with other available actions to customize tasks, such as automatically connecting to your tailnet if your device is not on your home Wi-Fi. Depending on how you set up your shortcuts, you access shortcuts in the Shortcuts app, the menu bar, in Spotlight, and other places.\r\n\r\nFor general information about macOS and iOS shortcuts, refer to Apple's [Shortcuts User Guide for Mac](https://support.apple.com/guide/shortcuts-mac/welcome/mac) and [Shortcuts User Guide for iOS](https://support.apple.com/guide/shortcuts/welcome/ios).\r\n\r\n## [Prerequisites](https://tailscale.com/docs/features/mac-ios-shortcuts\\#prerequisites)\r\n\r\nTo use Tailscale with the Shortcuts app, you must meet the following requirements:\r\n\r\n- Tailscale version 1.36 or later\r\n- macOS Monterey 12.0 or later\r\n- iOS 15.0 or later\r\n\r\n## [Available actions](https://tailscale.com/docs/features/mac-ios-shortcuts\\#available-actions)\r\n\r\nThe Tailscale client offers actions for interacting with accounts, devices, exit nodes, and your tailnet.\r\n\r\n### [Accounts](https://tailscale.com/docs/features/mac-ios-shortcuts\\#accounts)\r\n\r\nThe following Tailscale actions let you manage your Tailscale accounts:\r\n\r\n- [Find Accounts](https://tailscale.com/docs/features/mac-ios-shortcuts#find-accounts)\r\n- [Switch Accounts](https://tailscale.com/docs/features/mac-ios-shortcuts#switch-accounts)\r\n\r\n#### [Find Accounts](https://tailscale.com/docs/features/mac-ios-shortcuts\\#find-accounts)\r\n\r\nRetrieve accounts signed into the Tailscale client that match the provided criteria. You can filter accounts by **Display Name** or **Login Name**. You can also specify the sort by, sort order, and limit of the results.\r\n\r\n#### [Switch Accounts](https://tailscale.com/docs/features/mac-ios-shortcuts\\#switch-accounts)\r\n\r\n[Switch Tailscale user accounts](https://tailscale.com/docs/features/client/fast-user-switching). You can optionally specify the account username to which to switch. If you don't specify an account username, the action will ask you to select one when it runs.\r\n\r\n### [Devices](https://tailscale.com/docs/features/mac-ios-shortcuts\\#devices)\r\n\r\nThe following Tailscale actions let you manage devices:\r\n\r\n- [Find Devices](https://tailscale.com/docs/features/mac-ios-shortcuts#find-devices)\r\n- [Ping Devices](https://tailscale.com/docs/features/mac-ios-shortcuts#ping-devices)\r\n- [Send File](https://tailscale.com/docs/features/mac-ios-shortcuts#send-file)\r\n\r\n#### [Find Devices](https://tailscale.com/docs/features/mac-ios-shortcuts\\#find-devices)\r\n\r\nRetrieve all devices in your tailnet that match the provided criteria. You can filter devices by **Name** or connection status ( **Is Online** or **Is Offline**). You can also specify the sort by, sort order, and limit of the results.\r\n\r\n#### [Ping Devices](https://tailscale.com/docs/features/mac-ios-shortcuts\\#ping-devices)\r\n\r\nSend a [ping](https://tailscale.com/docs/reference/tailscale-cli#ping) to a device in your tailnet and retrieve the ping result. You can ping a device by its device name, [Tailscale IP address](https://tailscale.com/docs/concepts/tailscale-ip-addresses), [MagicDNS](https://tailscale.com/docs/features/magicdns) name, device ID, IPv4 address, or IPv6 address.\r\n\r\n#### [Send File](https://tailscale.com/docs/features/mac-ios-shortcuts\\#send-file)\r\n\r\nUse [Taildrop](https://tailscale.com/docs/features/taildrop) to send one or more files to a device in your tailnet. You specify the files to send and the device to which to send the files.\r\n\r\n### [Exit nodes](https://tailscale.com/docs/features/mac-ios-shortcuts\\#exit-nodes)\r\n\r\nYou must already have an exit node in your tailnet before using it from a macOS or iOS shortcut.\r\n\r\nExit node actions are sensitive actions because an exit node affects all network traffic on your device. On iOS, you must unlock your device before using an exit node action.\r\n\r\nThe following Tailscale actions let you manage [exit nodes](https://tailscale.com/docs/features/exit-nodes):\r\n\r\n- [Use Exit Node](https://tailscale.com/docs/features/mac-ios-shortcuts#use-exit-node)\r\n- [Stop Using Exit Node](https://tailscale.com/docs/features/mac-ios-shortcuts#stop-using-exit-node)\r\n\r\n#### [Use Exit Node](https://tailscale.com/docs/features/mac-ios-shortcuts\\#use-exit-node)\r\n\r\nSet your device to use an exit node by its [name](https://tailscale.com/docs/concepts/machine-names) or [Tailscale IP address](https://tailscale.com/docs/concepts/tailscale-ip-addresses).\r\n\r\n#### [Stop Using Exit Node](https://tailscale.com/docs/features/mac-ios-shortcuts\\#stop-using-exit-node)\r\n\r\nSet your device to stop using an exit node.\r\n\r\n### [Tailnet management](https://tailscale.com/docs/features/mac-ios-shortcuts\\#tailnet-management)\r\n\r\nThe following Tailscale actions let you manage your tailnet:\r\n\r\n- [Connect](https://tailscale.com/docs/features/mac-ios-shortcuts#connect)\r\n- [Disconnect](https://tailscale.com/docs/features/mac-ios-shortcuts#disconnect)\r\n- [Get Status](https://tailscale.com/docs/features/mac-ios-shortcuts#get-status)\r\n- [Set Tailscale DNS](https://tailscale.com/docs/features/mac-ios-shortcuts#set-tailscale-dns)\r\n- [Toggle](https://tailscale.com/docs/features/mac-ios-shortcuts#toggle)\r\n\r\n#### [Connect](https://tailscale.com/docs/features/mac-ios-shortcuts\\#connect)\r\n\r\nConnect your device to your tailnet.\r\n\r\n#### [Disconnect](https://tailscale.com/docs/features/mac-ios-shortcuts\\#disconnect)\r\n\r\nDisconnect your device from your tailnet.\r\n\r\n#### [Get Status](https://tailscale.com/docs/features/mac-ios-shortcuts\\#get-status)\r\n\r\nRetrieve status information about the Tailscale client. It returns the following values:\r\n\r\n- **Connected** (`boolean`): Whether the device is connected to a tailnet.\r\n- **Account Name** (`string`): The Tailscale username (such as `alice@example.com`).\r\n- **Using Exit Node** (`boolean`): Whether the device currently uses an exit node.\r\n- **Exit Node Name** (`string`): The name of the exit node.\r\n\r\n#### [Set Tailscale DNS](https://tailscale.com/docs/features/mac-ios-shortcuts\\#set-tailscale-dns)\r\n\r\nModify whether your device uses [Tailscale DNS](https://tailscale.com/docs/reference/dns-in-tailscale). You can use this action to:\r\n\r\n- Turn on Tailscale DNS.\r\n- Turn off Tailscale DNS.\r\n- Toggle using Tailscale DNS (the result varies depending on the status when the action runs).\r\n\r\n#### [Toggle](https://tailscale.com/docs/features/mac-ios-shortcuts\\#toggle)\r\n\r\nToggle the connection status of your device. You can use this action to connect to or disconnect from your tailnet. After the action runs, it returns either **Yes** or **No** to indicate whether the device is connected (Yes) or disconnected (No).\r\n\r\n## [Examples](https://tailscale.com/docs/features/mac-ios-shortcuts\\#examples)\r\n\r\n### [Switch accounts](https://tailscale.com/docs/features/mac-ios-shortcuts\\#switch-accounts-1)\r\n\r\nThis example shows how to create a [macOS shortcut](https://support.apple.com/guide/shortcuts-mac/welcome/mac) that switches between Tailscale accounts. The example uses the [Get Status](https://tailscale.com/docs/features/mac-ios-shortcuts#get-status) and the [Switch Account](https://tailscale.com/docs/features/mac-ios-shortcuts#switch-accounts) actions.\r\n\r\n01. In the **Shortcuts** app, select **File** and then select **New Shortcut**.\r\n02. Select **Shortcut Name** and provide a name, such as **Switch Tailscale user**.\r\n03. In the right-hand panel, select **Apps**.\r\n04. Search for or scroll to the **Tailscale** app and select it.\r\n05. Drag the **Get Status** action to the shortcut editor.\r\n06. In the right-hand panel, search for the **If** action, and drag the **If** action to the shortcut editor and place it below the **Get status** statement. You can also find the **If** action by selecting **Categories**, **Scripting**, and then **Control Flow**.\r\n07. For the **If** statement, select **Status** and choose the Tailscale **Account Name** variable.\r\n08. Select **Condition**, select **Is**, and then select **Text**. Enter a user account, such as `alice@example.com`.\r\n09. From the right-hand panel, drag the **Switch Account** action to the shortcut editor, and place it below the **If** statement but above the **Otherwise** statement.\r\n10. For the **Switch account to** statement, select **account name**. For the value, use a different user account, such as `alice@gmail.com`.\r\n11. From the right-hand panel, drag another **Switch Account** action to the shortcut editor, and place it below the **Otherwise** statement but above the **End if** statement.\r\n12. Edit this **Switch account to** statement to use the original user account value, `alice@example.com`.\r\n13. Test your shortcut by selecting the **Run** icon at the top of the shortcut editor.\r\n\r\nYou can access and run the shortcut you created in the Shortcuts app **All Shortcuts** folder. You can also add the shortcut to the **Menu Bar** folder, which makes the shortcut appear in the macOS taskbar.\r\n\r\n### [Connect to your tailnet](https://tailscale.com/docs/features/mac-ios-shortcuts\\#connect-to-your-tailnet)\r\n\r\nThis example shows how to create an [iOS shortcut](https://support.apple.com/guide/shortcuts/welcome/ios) that automatically connects your device to your tailnet when your devices joins a specific Wi-Fi network. The example uses the [Connect](https://tailscale.com/docs/features/mac-ios-shortcuts#connect) action.\r\n\r\nIn this example, the Wi-Fi network name is _PangoLAN_.\r\n\r\n1. Launch the **Shortcuts app**, then select **Automation**.\r\n2. Select the **＋**, then select **Create Personal Automation**.\r\n3. From the **Wi-Fi** category, choose the \"PangoLAN\" network.\r\n4. Select **Next**.\r\n5. Select **Add Action**.\r\n6. From the **Tailscale** app group, select the **Connect** action.\r\n7. Select **Next**.\r\n8. Select **Done**.\r\n\r\n![Project Logo](https://cdn.brandfetch.io/tailscale.com/fallback/lettermark/theme/dark/h/256/w/256/icon?c=1bfwsmEH20zzEfSNTed)\r\n\r\nAsk AI\r\n\r\nreCAPTCHA\r\n\r\nRecaptcha requires verification.\r\n\r\nprotected by **reCAPTCHA**\r\n","html":"<h1>macOS and iOS shortcuts</h1>\n<p>Last validated: Jan 5, 2026</p>\n<p>Tailscale works with the Shortcuts app on macOS and iOS to provide several built-in shortcut actions, allowing you to automate tasks. For example, you can create shortcuts to connect your device to a tailnet, use an exit node, or switch user accounts.</p>\n<p>You can combine the Tailscale actions with other available actions to customize tasks, such as automatically connecting to your tailnet if your device is not on your home Wi-Fi. Depending on how you set up your shortcuts, you access shortcuts in the Shortcuts app, the menu bar, in Spotlight, and other places.</p>\n<p>For general information about macOS and iOS shortcuts, refer to Apple's <a href=\"https://support.apple.com/guide/shortcuts-mac/welcome/mac\">Shortcuts User Guide for Mac</a> and <a href=\"https://support.apple.com/guide/shortcuts/welcome/ios\">Shortcuts User Guide for iOS</a>.</p>\n<h2><a href=\"https://tailscale.com/docs/features/mac-ios-shortcuts#prerequisites\">Prerequisites</a></h2>\n<p>To use Tailscale with the Shortcuts app, you must meet the following requirements:</p>\n<ul>\n<li>Tailscale version 1.36 or later</li>\n<li>macOS Monterey 12.0 or later</li>\n<li>iOS 15.0 or later</li>\n</ul>\n<h2><a href=\"https://tailscale.com/docs/features/mac-ios-shortcuts#available-actions\">Available actions</a></h2>\n<p>The Tailscale client offers actions for interacting with accounts, devices, exit nodes, and your tailnet.</p>\n<h3><a href=\"https://tailscale.com/docs/features/mac-ios-shortcuts#accounts\">Accounts</a></h3>\n<p>The following Tailscale actions let you manage your Tailscale accounts:</p>\n<ul>\n<li><a href=\"https://tailscale.com/docs/features/mac-ios-shortcuts#find-accounts\">Find Accounts</a></li>\n<li><a href=\"https://tailscale.com/docs/features/mac-ios-shortcuts#switch-accounts\">Switch Accounts</a></li>\n</ul>\n<h4><a href=\"https://tailscale.com/docs/features/mac-ios-shortcuts#find-accounts\">Find Accounts</a></h4>\n<p>Retrieve accounts signed into the Tailscale client that match the provided criteria. You can filter accounts by <strong>Display Name</strong> or <strong>Login Name</strong>. You can also specify the sort by, sort order, and limit of the results.</p>\n<h4><a href=\"https://tailscale.com/docs/features/mac-ios-shortcuts#switch-accounts\">Switch Accounts</a></h4>\n<p><a href=\"https://tailscale.com/docs/features/client/fast-user-switching\">Switch Tailscale user accounts</a>. You can optionally specify the account username to which to switch. If you don't specify an account username, the action will ask you to select one when it runs.</p>\n<h3><a href=\"https://tailscale.com/docs/features/mac-ios-shortcuts#devices\">Devices</a></h3>\n<p>The following Tailscale actions let you manage devices:</p>\n<ul>\n<li><a href=\"https://tailscale.com/docs/features/mac-ios-shortcuts#find-devices\">Find Devices</a></li>\n<li><a href=\"https://tailscale.com/docs/features/mac-ios-shortcuts#ping-devices\">Ping Devices</a></li>\n<li><a href=\"https://tailscale.com/docs/features/mac-ios-shortcuts#send-file\">Send File</a></li>\n</ul>\n<h4><a href=\"https://tailscale.com/docs/features/mac-ios-shortcuts#find-devices\">Find Devices</a></h4>\n<p>Retrieve all devices in your tailnet that match the provided criteria. You can filter devices by <strong>Name</strong> or connection status ( <strong>Is Online</strong> or <strong>Is Offline</strong>). You can also specify the sort by, sort order, and limit of the results.</p>\n<h4><a href=\"https://tailscale.com/docs/features/mac-ios-shortcuts#ping-devices\">Ping Devices</a></h4>\n<p>Send a <a href=\"https://tailscale.com/docs/reference/tailscale-cli#ping\">ping</a> to a device in your tailnet and retrieve the ping result. You can ping a device by its device name, <a href=\"https://tailscale.com/docs/concepts/tailscale-ip-addresses\">Tailscale IP address</a>, <a href=\"https://tailscale.com/docs/features/magicdns\">MagicDNS</a> name, device ID, IPv4 address, or IPv6 address.</p>\n<h4><a href=\"https://tailscale.com/docs/features/mac-ios-shortcuts#send-file\">Send File</a></h4>\n<p>Use <a href=\"https://tailscale.com/docs/features/taildrop\">Taildrop</a> to send one or more files to a device in your tailnet. You specify the files to send and the device to which to send the files.</p>\n<h3><a href=\"https://tailscale.com/docs/features/mac-ios-shortcuts#exit-nodes\">Exit nodes</a></h3>\n<p>You must already have an exit node in your tailnet before using it from a macOS or iOS shortcut.</p>\n<p>Exit node actions are sensitive actions because an exit node affects all network traffic on your device. On iOS, you must unlock your device before using an exit node action.</p>\n<p>The following Tailscale actions let you manage <a href=\"https://tailscale.com/docs/features/exit-nodes\">exit nodes</a>:</p>\n<ul>\n<li><a href=\"https://tailscale.com/docs/features/mac-ios-shortcuts#use-exit-node\">Use Exit Node</a></li>\n<li><a href=\"https://tailscale.com/docs/features/mac-ios-shortcuts#stop-using-exit-node\">Stop Using Exit Node</a></li>\n</ul>\n<h4><a href=\"https://tailscale.com/docs/features/mac-ios-shortcuts#use-exit-node\">Use Exit Node</a></h4>\n<p>Set your device to use an exit node by its <a href=\"https://tailscale.com/docs/concepts/machine-names\">name</a> or <a href=\"https://tailscale.com/docs/concepts/tailscale-ip-addresses\">Tailscale IP address</a>.</p>\n<h4><a href=\"https://tailscale.com/docs/features/mac-ios-shortcuts#stop-using-exit-node\">Stop Using Exit Node</a></h4>\n<p>Set your device to stop using an exit node.</p>\n<h3><a href=\"https://tailscale.com/docs/features/mac-ios-shortcuts#tailnet-management\">Tailnet management</a></h3>\n<p>The following Tailscale actions let you manage your tailnet:</p>\n<ul>\n<li><a href=\"https://tailscale.com/docs/features/mac-ios-shortcuts#connect\">Connect</a></li>\n<li><a href=\"https://tailscale.com/docs/features/mac-ios-shortcuts#disconnect\">Disconnect</a></li>\n<li><a href=\"https://tailscale.com/docs/features/mac-ios-shortcuts#get-status\">Get Status</a></li>\n<li><a href=\"https://tailscale.com/docs/features/mac-ios-shortcuts#set-tailscale-dns\">Set Tailscale DNS</a></li>\n<li><a href=\"https://tailscale.com/docs/features/mac-ios-shortcuts#toggle\">Toggle</a></li>\n</ul>\n<h4><a href=\"https://tailscale.com/docs/features/mac-ios-shortcuts#connect\">Connect</a></h4>\n<p>Connect your device to your tailnet.</p>\n<h4><a href=\"https://tailscale.com/docs/features/mac-ios-shortcuts#disconnect\">Disconnect</a></h4>\n<p>Disconnect your device from your tailnet.</p>\n<h4><a href=\"https://tailscale.com/docs/features/mac-ios-shortcuts#get-status\">Get Status</a></h4>\n<p>Retrieve status information about the Tailscale client. It returns the following values:</p>\n<ul>\n<li><strong>Connected</strong> (<code>boolean</code>): Whether the device is connected to a tailnet.</li>\n<li><strong>Account Name</strong> (<code>string</code>): The Tailscale username (such as <code>alice@example.com</code>).</li>\n<li><strong>Using Exit Node</strong> (<code>boolean</code>): Whether the device currently uses an exit node.</li>\n<li><strong>Exit Node Name</strong> (<code>string</code>): The name of the exit node.</li>\n</ul>\n<h4><a href=\"https://tailscale.com/docs/features/mac-ios-shortcuts#set-tailscale-dns\">Set Tailscale DNS</a></h4>\n<p>Modify whether your device uses <a href=\"https://tailscale.com/docs/reference/dns-in-tailscale\">Tailscale DNS</a>. You can use this action to:</p>\n<ul>\n<li>Turn on Tailscale DNS.</li>\n<li>Turn off Tailscale DNS.</li>\n<li>Toggle using Tailscale DNS (the result varies depending on the status when the action runs).</li>\n</ul>\n<h4><a href=\"https://tailscale.com/docs/features/mac-ios-shortcuts#toggle\">Toggle</a></h4>\n<p>Toggle the connection status of your device. You can use this action to connect to or disconnect from your tailnet. After the action runs, it returns either <strong>Yes</strong> or <strong>No</strong> to indicate whether the device is connected (Yes) or disconnected (No).</p>\n<h2><a href=\"https://tailscale.com/docs/features/mac-ios-shortcuts#examples\">Examples</a></h2>\n<h3><a href=\"https://tailscale.com/docs/features/mac-ios-shortcuts#switch-accounts-1\">Switch accounts</a></h3>\n<p>This example shows how to create a <a href=\"https://support.apple.com/guide/shortcuts-mac/welcome/mac\">macOS shortcut</a> that switches between Tailscale accounts. The example uses the <a href=\"https://tailscale.com/docs/features/mac-ios-shortcuts#get-status\">Get Status</a> and the <a href=\"https://tailscale.com/docs/features/mac-ios-shortcuts#switch-accounts\">Switch Account</a> actions.</p>\n<ol>\n<li>In the <strong>Shortcuts</strong> app, select <strong>File</strong> and then select <strong>New Shortcut</strong>.</li>\n<li>Select <strong>Shortcut Name</strong> and provide a name, such as <strong>Switch Tailscale user</strong>.</li>\n<li>In the right-hand panel, select <strong>Apps</strong>.</li>\n<li>Search for or scroll to the <strong>Tailscale</strong> app and select it.</li>\n<li>Drag the <strong>Get Status</strong> action to the shortcut editor.</li>\n<li>In the right-hand panel, search for the <strong>If</strong> action, and drag the <strong>If</strong> action to the shortcut editor and place it below the <strong>Get status</strong> statement. You can also find the <strong>If</strong> action by selecting <strong>Categories</strong>, <strong>Scripting</strong>, and then <strong>Control Flow</strong>.</li>\n<li>For the <strong>If</strong> statement, select <strong>Status</strong> and choose the Tailscale <strong>Account Name</strong> variable.</li>\n<li>Select <strong>Condition</strong>, select <strong>Is</strong>, and then select <strong>Text</strong>. Enter a user account, such as <code>alice@example.com</code>.</li>\n<li>From the right-hand panel, drag the <strong>Switch Account</strong> action to the shortcut editor, and place it below the <strong>If</strong> statement but above the <strong>Otherwise</strong> statement.</li>\n<li>For the <strong>Switch account to</strong> statement, select <strong>account name</strong>. For the value, use a different user account, such as <code>alice@gmail.com</code>.</li>\n<li>From the right-hand panel, drag another <strong>Switch Account</strong> action to the shortcut editor, and place it below the <strong>Otherwise</strong> statement but above the <strong>End if</strong> statement.</li>\n<li>Edit this <strong>Switch account to</strong> statement to use the original user account value, <code>alice@example.com</code>.</li>\n<li>Test your shortcut by selecting the <strong>Run</strong> icon at the top of the shortcut editor.</li>\n</ol>\n<p>You can access and run the shortcut you created in the Shortcuts app <strong>All Shortcuts</strong> folder. You can also add the shortcut to the <strong>Menu Bar</strong> folder, which makes the shortcut appear in the macOS taskbar.</p>\n<h3><a href=\"https://tailscale.com/docs/features/mac-ios-shortcuts#connect-to-your-tailnet\">Connect to your tailnet</a></h3>\n<p>This example shows how to create an <a href=\"https://support.apple.com/guide/shortcuts/welcome/ios\">iOS shortcut</a> that automatically connects your device to your tailnet when your devices joins a specific Wi-Fi network. The example uses the <a href=\"https://tailscale.com/docs/features/mac-ios-shortcuts#connect\">Connect</a> action.</p>\n<p>In this example, the Wi-Fi network name is <em>PangoLAN</em>.</p>\n<ol>\n<li>Launch the <strong>Shortcuts app</strong>, then select <strong>Automation</strong>.</li>\n<li>Select the <strong>＋</strong>, then select <strong>Create Personal Automation</strong>.</li>\n<li>From the <strong>Wi-Fi</strong> category, choose the \"PangoLAN\" network.</li>\n<li>Select <strong>Next</strong>.</li>\n<li>Select <strong>Add Action</strong>.</li>\n<li>From the <strong>Tailscale</strong> app group, select the <strong>Connect</strong> action.</li>\n<li>Select <strong>Next</strong>.</li>\n<li>Select <strong>Done</strong>.</li>\n</ol>\n<p><img src=\"https://cdn.brandfetch.io/tailscale.com/fallback/lettermark/theme/dark/h/256/w/256/icon?c=1bfwsmEH20zzEfSNTed\" alt=\"Project Logo\"></p>\n<p>Ask AI</p>\n<p>reCAPTCHA</p>\n<p>Recaptcha requires verification.</p>\n<p>protected by <strong>reCAPTCHA</strong></p>\n"}