apple-mcp-mail 1.0.1__tar.gz

apple_mcp_mail-1.0.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Apple MCP Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

apple_mcp_mail-1.0.1/PKG-INFO

@@ -0,0 +1,157 @@
+Metadata-Version: 2.4
+Name: apple-mcp-mail
+Version: 1.0.1
+Summary: Local MCP server for Apple Mail on macOS
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/JonathanRReed/Apple-MCPs
+Project-URL: Repository, https://github.com/JonathanRReed/Apple-MCPs
+Project-URL: Changelog, https://github.com/JonathanRReed/Apple-MCPs/blob/main/CHANGELOG.md
+Project-URL: Issues, https://github.com/JonathanRReed/Apple-MCPs/issues
+Keywords: mcp,model-context-protocol,macos,apple,ai-agent,automation
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Environment :: MacOS X
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: MacOS
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: apple-mcp-common<2,>=1.0.0
+Requires-Dist: mcp<3,>=2.0.0
+Requires-Dist: pydantic>=2.12.0
+Provides-Extra: dev
+Requires-Dist: pytest<10,>=8; extra == "dev"
+Requires-Dist: ruff<1,>=0.12; extra == "dev"
+Dynamic: license-file
+
+<!-- mcp-name: io.github.jonathanrreed/apple-mcp-mail -->
+
+# Apple Mail MCP
+
+MCP server for Apple Mail on macOS.
+
+Provides access to mailboxes, message search, reading, and composition. Keep Mail as the system of record while enabling agents to search, read, draft, and send email.
+
+## When to use
+
+- Mail-only workflows
+- Tighter permissions than the all-in-one server
+- Draft and send workflows through the native Mail app
+
+## What It Does
+
+- List mailboxes
+- Search and read messages
+- Create drafts and send messages
+- Reply, forward, mark read/unread, move, and delete
+- Tool discovery helpers `search_tools` and `get_tool_info` for context-constrained clients
+- Thread helpers: `mail_get_thread`, `mail_reply_latest_in_thread`, `mail_archive_thread`
+- Mailbox resources and reply-oriented prompts
+- Health and permission checks: `mail_health`, `mail_permission_guide`, `mail_recheck_permissions`
+
+## Tools
+
+`mail_health`, `mail_permission_guide`, `mail_recheck_permissions`, `mail_list_mailboxes`, `mail_search_messages`, `mail_get_message`, `mail_get_thread`, `mail_compose_draft`, `mail_send_message`, `mail_reply_message`, `mail_forward_message`, `mail_mark_message`, `mail_move_message`, `mail_delete_message`, `mail_reply_latest_in_thread`, `mail_archive_thread`, `mail_list_prompts`, `mail_get_prompt`, plus the discovery helpers `search_tools` and `get_tool_info`.
+
+## Install On This Mac
+
+<details>
+<summary>Quick start (uvx, from PyPI)</summary>
+
+With [uv](https://docs.astral.sh/uv/getting-started/installation/) installed:
+
+```bash
+uvx apple-mcp-mail
+```
+
+No clone, no venv management.
+
+</details>
+
+<details>
+<summary>From a clone</summary>
+
+```bash
+git clone https://github.com/JonathanRReed/Apple-MCPs.git
+cd Apple-MCPs
+uv sync --all-packages
+```
+
+This builds one workspace environment with every server's entry point in `.venv/bin` (for example `.venv/bin/apple-mail-mcp`). You can also point an MCP client at `AppleMail-MCP/start.sh`, which prefers `uv run` and falls back to a plain venv bootstrap (Python 3.11+ required).
+
+</details>
+
+## Install In AI Agents
+
+<details>
+<summary>Generic MCP client config</summary>
+
+```json
+{
+  "mcpServers": {
+    "apple-mail": {
+      "command": "uvx",
+      "args": ["apple-mcp-mail"],
+      "env": {
+        "APPLE_MAIL_MCP_SAFETY_PROFILE": "safe_manage",
+        "APPLE_MAIL_MCP_VISIBLE_DRAFTS": "true"
+      }
+    }
+  }
+}
+```
+
+Running from a clone instead? Use `/path/to/Apple-MCPs/AppleMail-MCP/start.sh` as the command with empty `args`.
+
+</details>
+
+<details>
+<summary>Claude Code example</summary>
+
+```bash
+claude mcp add --transport stdio --scope project apple-mail -- uvx apple-mcp-mail
+```
+
+</details>
+
+## Safety Modes
+
+- `safe_readonly`, read and search only
+- `safe_manage`, read plus draft creation
+- `full_access`, full Mail tool surface in this repo
+
+## Transport
+
+`stdio` is the default and recommended transport. Set `APPLE_MAIL_MCP_TRANSPORT=streamable-http` (with optional `APPLE_MAIL_MCP_HOST` and `APPLE_MAIL_MCP_PORT`) to serve Streamable HTTP instead.
+
+## macOS Permissions
+
+- Automation access to Mail is required
+
+## Launch Checklist
+
+- Add `uvx apple-mcp-mail` (or a clone's `AppleMail-MCP/start.sh`) to your MCP client
+- Reload or reconnect the client so the Mail tool surface is loaded into context
+- Call `mail_health` first to confirm the server is reachable
+- If Mail automation is blocked, call `mail_permission_guide`
+- After changing macOS permissions, call `mail_recheck_permissions`
+
+## Prompting Notes
+
+- Run Contacts before any send or reply when the user identifies a person rather than an email address.
+- `tools/list` returns the full Mail tool surface. Context-constrained clients can call `search_tools` first, then `get_tool_info` for the exact Mail tool they plan to call.
+- `mail_search_messages` requires a query string. Use a sender, a subject fragment, or `*` as a wildcard.
+- There is no list-all recent-mail endpoint.
+- Use `mail_get_thread` when the user means a conversation, not a single message.
+- Use `mail_reply_latest_in_thread` when the agent should reply to the newest message in the conversation.
+- Use `mail_archive_thread` when the user wants thread-level cleanup and Archive is the intended mailbox.
+- If the user could mean text or email, ask once before choosing Messages or Mail.
+- When Mail must send from a specific identity, pass the exact sender email in `from_account`.
+
+## Related
+
+- [Apple-Tools-MCP](../Apple-Tools-MCP/README.md)

apple_mcp_mail-1.0.1/README.md

@@ -0,0 +1,127 @@
+<!-- mcp-name: io.github.jonathanrreed/apple-mcp-mail -->
+
+# Apple Mail MCP
+
+MCP server for Apple Mail on macOS.
+
+Provides access to mailboxes, message search, reading, and composition. Keep Mail as the system of record while enabling agents to search, read, draft, and send email.
+
+## When to use
+
+- Mail-only workflows
+- Tighter permissions than the all-in-one server
+- Draft and send workflows through the native Mail app
+
+## What It Does
+
+- List mailboxes
+- Search and read messages
+- Create drafts and send messages
+- Reply, forward, mark read/unread, move, and delete
+- Tool discovery helpers `search_tools` and `get_tool_info` for context-constrained clients
+- Thread helpers: `mail_get_thread`, `mail_reply_latest_in_thread`, `mail_archive_thread`
+- Mailbox resources and reply-oriented prompts
+- Health and permission checks: `mail_health`, `mail_permission_guide`, `mail_recheck_permissions`
+
+## Tools
+
+`mail_health`, `mail_permission_guide`, `mail_recheck_permissions`, `mail_list_mailboxes`, `mail_search_messages`, `mail_get_message`, `mail_get_thread`, `mail_compose_draft`, `mail_send_message`, `mail_reply_message`, `mail_forward_message`, `mail_mark_message`, `mail_move_message`, `mail_delete_message`, `mail_reply_latest_in_thread`, `mail_archive_thread`, `mail_list_prompts`, `mail_get_prompt`, plus the discovery helpers `search_tools` and `get_tool_info`.
+
+## Install On This Mac
+
+<details>
+<summary>Quick start (uvx, from PyPI)</summary>
+
+With [uv](https://docs.astral.sh/uv/getting-started/installation/) installed:
+
+```bash
+uvx apple-mcp-mail
+```
+
+No clone, no venv management.
+
+</details>
+
+<details>
+<summary>From a clone</summary>
+
+```bash
+git clone https://github.com/JonathanRReed/Apple-MCPs.git
+cd Apple-MCPs
+uv sync --all-packages
+```
+
+This builds one workspace environment with every server's entry point in `.venv/bin` (for example `.venv/bin/apple-mail-mcp`). You can also point an MCP client at `AppleMail-MCP/start.sh`, which prefers `uv run` and falls back to a plain venv bootstrap (Python 3.11+ required).
+
+</details>
+
+## Install In AI Agents
+
+<details>
+<summary>Generic MCP client config</summary>
+
+```json
+{
+  "mcpServers": {
+    "apple-mail": {
+      "command": "uvx",
+      "args": ["apple-mcp-mail"],
+      "env": {
+        "APPLE_MAIL_MCP_SAFETY_PROFILE": "safe_manage",
+        "APPLE_MAIL_MCP_VISIBLE_DRAFTS": "true"
+      }
+    }
+  }
+}
+```
+
+Running from a clone instead? Use `/path/to/Apple-MCPs/AppleMail-MCP/start.sh` as the command with empty `args`.
+
+</details>
+
+<details>
+<summary>Claude Code example</summary>
+
+```bash
+claude mcp add --transport stdio --scope project apple-mail -- uvx apple-mcp-mail
+```
+
+</details>
+
+## Safety Modes
+
+- `safe_readonly`, read and search only
+- `safe_manage`, read plus draft creation
+- `full_access`, full Mail tool surface in this repo
+
+## Transport
+
+`stdio` is the default and recommended transport. Set `APPLE_MAIL_MCP_TRANSPORT=streamable-http` (with optional `APPLE_MAIL_MCP_HOST` and `APPLE_MAIL_MCP_PORT`) to serve Streamable HTTP instead.
+
+## macOS Permissions
+
+- Automation access to Mail is required
+
+## Launch Checklist
+
+- Add `uvx apple-mcp-mail` (or a clone's `AppleMail-MCP/start.sh`) to your MCP client
+- Reload or reconnect the client so the Mail tool surface is loaded into context
+- Call `mail_health` first to confirm the server is reachable
+- If Mail automation is blocked, call `mail_permission_guide`
+- After changing macOS permissions, call `mail_recheck_permissions`
+
+## Prompting Notes
+
+- Run Contacts before any send or reply when the user identifies a person rather than an email address.
+- `tools/list` returns the full Mail tool surface. Context-constrained clients can call `search_tools` first, then `get_tool_info` for the exact Mail tool they plan to call.
+- `mail_search_messages` requires a query string. Use a sender, a subject fragment, or `*` as a wildcard.
+- There is no list-all recent-mail endpoint.
+- Use `mail_get_thread` when the user means a conversation, not a single message.
+- Use `mail_reply_latest_in_thread` when the agent should reply to the newest message in the conversation.
+- Use `mail_archive_thread` when the user wants thread-level cleanup and Archive is the intended mailbox.
+- If the user could mean text or email, ask once before choosing Messages or Mail.
+- When Mail must send from a specific identity, pass the exact sender email in `from_account`.
+
+## Related
+
+- [Apple-Tools-MCP](../Apple-Tools-MCP/README.md)

apple_mcp_mail-1.0.1/pyproject.toml

@@ -0,0 +1,61 @@
+[build-system]
+requires = ["setuptools>=77", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "apple-mcp-mail"
+version = "1.0.1"
+description = "Local MCP server for Apple Mail on macOS"
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+requires-python = ">=3.11"
+keywords = ["mcp", "model-context-protocol", "macos", "apple", "ai-agent", "automation"]
+classifiers = [
+  "Development Status :: 5 - Production/Stable",
+  "Environment :: MacOS X",
+  "Intended Audience :: Developers",
+  "Operating System :: MacOS",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "Programming Language :: Python :: 3.13",
+  "Programming Language :: Python :: 3.14",
+  "Topic :: Software Development :: Libraries :: Python Modules",
+]
+dependencies = [
+  "apple-mcp-common>=1.0.0,<2",
+  "mcp>=2.0.0,<3",
+  "pydantic>=2.12.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/JonathanRReed/Apple-MCPs"
+Repository = "https://github.com/JonathanRReed/Apple-MCPs"
+Changelog = "https://github.com/JonathanRReed/Apple-MCPs/blob/main/CHANGELOG.md"
+Issues = "https://github.com/JonathanRReed/Apple-MCPs/issues"
+
+[project.scripts]
+apple-mail-mcp = "apple_mail_mcp.tools:main"
+apple-mcp-mail = "apple_mail_mcp.tools:main"
+
+[project.optional-dependencies]
+dev = [
+  "pytest>=8,<10",
+  "ruff>=0.12,<1",
+]
+
+[tool.setuptools]
+package-dir = {"" = "src"}
+
+[tool.setuptools.package-data]
+apple_mail_mcp = ["applescripts/*.applescript"]
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.pytest.ini_options]
+pythonpath = ["src"]
+testpaths = ["tests"]
+
+[tool.uv.sources]
+apple-mcp-common = { workspace = true }

apple_mcp_mail-1.0.1/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

apple_mcp_mail-1.0.1/src/apple_mail_mcp/__init__.py

@@ -0,0 +1,3 @@
+__all__ = ["__version__"]
+
+__version__ = "0.1.0"

apple_mcp_mail-1.0.1/src/apple_mail_mcp/__main__.py

@@ -0,0 +1,4 @@
+from apple_mail_mcp.tools import main
+
+if __name__ == "__main__":
+    main()

apple_mcp_mail-1.0.1/src/apple_mail_mcp/applescripts/compose_draft.applescript

@@ -0,0 +1,225 @@
+on splitText(sourceText, separatorValue)
+    if sourceText is "" then
+        return {}
+    end if
+    set previousDelimiters to AppleScript's text item delimiters
+    set AppleScript's text item delimiters to separatorValue
+    set textParts to text items of sourceText
+    set AppleScript's text item delimiters to previousDelimiters
+    return textParts
+end splitText
+
+on replaceText(sourceText, findText, replacementText)
+    set previousDelimiters to AppleScript's text item delimiters
+    set AppleScript's text item delimiters to findText
+    set textParts to text items of sourceText
+    set AppleScript's text item delimiters to replacementText
+    set outputText to textParts as text
+    set AppleScript's text item delimiters to previousDelimiters
+    return outputText
+end replaceText
+
+on sanitizeText(valueText)
+    if valueText is missing value then
+        return ""
+    end if
+    set safeText to valueText as text
+    set safeText to my replaceText(safeText, return, "\\n")
+    set safeText to my replaceText(safeText, linefeed, "\\n")
+    set safeText to my replaceText(safeText, (ASCII character 31), " ")
+    set safeText to my replaceText(safeText, (ASCII character 30), " ")
+    set safeText to my replaceText(safeText, (ASCII character 29), " ")
+    return safeText
+end sanitizeText
+
+on normalizeText(valueText)
+    if valueText is missing value then
+        return ""
+    end if
+    set normalizedText to do shell script "/bin/echo " & quoted form of (valueText as text) & " | /usr/bin/tr '[:upper:]' '[:lower:]'"
+    return normalizedText
+end normalizeText
+
+on boolText(flagValue)
+    if flagValue then
+        return "true"
+    end if
+    return "false"
+end boolText
+
+on resolveAccountBySender(senderRaw)
+    if senderRaw is "" then
+        return missing value
+    end if
+    tell application "Mail"
+        repeat with theAccount in every account
+            try
+                if (name of theAccount as text) is senderRaw then
+                    return theAccount
+                end if
+            end try
+            try
+                if (email addresses of theAccount) contains senderRaw then
+                    return theAccount
+                end if
+            end try
+        end repeat
+    end tell
+    error "ACCOUNT_NOT_FOUND"
+end resolveAccountBySender
+
+on primaryEmailForAccount(theAccount)
+    tell application "Mail"
+        try
+            return item 1 of (email addresses of theAccount) as text
+        end try
+    end tell
+    return ""
+end primaryEmailForAccount
+
+on senderMatches(candidateText, senderRaw, senderEmail)
+    set normalizedCandidate to my normalizeText(candidateText)
+    if senderEmail is not "" then
+        set normalizedEmail to my normalizeText(senderEmail)
+        if normalizedCandidate contains normalizedEmail then
+            return true
+        end if
+    end if
+    if senderRaw is not "" then
+        set normalizedSender to my normalizeText(senderRaw)
+        if normalizedCandidate contains normalizedSender then
+            return true
+        end if
+    end if
+    return false
+end senderMatches
+
+on currentSenderMatches(senderRaw, senderEmail)
+    tell application "System Events"
+        tell process "Mail"
+            set frontmost to true
+            set composeWindow to front window
+            repeat with popupRef in every pop up button of composeWindow
+                try
+                    set currentValue to value of popupRef as text
+                    if my senderMatches(currentValue, senderRaw, senderEmail) then
+                        return currentValue
+                    end if
+                end try
+            end repeat
+        end tell
+    end tell
+    return ""
+end currentSenderMatches
+
+on selectSenderPopup(senderRaw, senderEmail)
+    tell application "Mail" to activate
+    repeat with attemptIndex from 1 to 5
+        delay 0.3
+        set currentMatch to my currentSenderMatches(senderRaw, senderEmail)
+        if currentMatch is not "" then
+            return currentMatch
+        end if
+        tell application "System Events"
+            tell process "Mail"
+                set frontmost to true
+                set composeWindow to front window
+                repeat with popupRef in every pop up button of composeWindow
+                    click popupRef
+                    delay 0.25
+                    set matchingItem to missing value
+                    try
+                        repeat with menuItemRef in every menu item of menu 1 of popupRef
+                            set itemName to name of menuItemRef as text
+                            if my senderMatches(itemName, senderRaw, senderEmail) then
+                                set matchingItem to menuItemRef
+                                exit repeat
+                            end if
+                        end repeat
+                    end try
+                    if matchingItem is not missing value then
+                        click matchingItem
+                        delay 0.4
+                        set updatedMatch to my currentSenderMatches(senderRaw, senderEmail)
+                        if updatedMatch is not "" then
+                            return updatedMatch
+                        end if
+                    end if
+                    key code 53
+                    delay 0.1
+                end repeat
+            end tell
+        end tell
+    end repeat
+    error "ACCOUNT_MENU_ITEM_NOT_FOUND"
+end selectSenderPopup
+
+on run argv
+    set toRaw to item 1 of argv
+    set ccRaw to item 2 of argv
+    set bccRaw to item 3 of argv
+    set subjectText to item 4 of argv
+    set bodyText to item 5 of argv
+    set attachmentRaw to item 6 of argv
+    set visibleText to item 7 of argv
+    set senderRaw to item 8 of argv
+
+    set fieldSeparator to ASCII character 31
+    set recordSeparator to ASCII character 30
+    set listSeparator to ASCII character 29
+    set toList to my splitText(toRaw, listSeparator)
+    set ccList to my splitText(ccRaw, listSeparator)
+    set bccList to my splitText(bccRaw, listSeparator)
+    set attachmentList to my splitText(attachmentRaw, listSeparator)
+    set shouldBeVisible to true
+    if visibleText is "false" then
+        set shouldBeVisible to false
+    end if
+
+    set resolvedAccountLabel to ""
+    set senderEmail to ""
+
+    tell application "Mail"
+        set effectiveVisible to shouldBeVisible
+        if senderRaw is not "" then
+            set effectiveVisible to true
+        end if
+        set newMessage to make new outgoing message with properties {visible:effectiveVisible, subject:subjectText, content:bodyText}
+        if senderRaw is not "" then
+            set matchedAccount to my resolveAccountBySender(senderRaw)
+            set senderEmail to my primaryEmailForAccount(matchedAccount)
+            set sender of newMessage to senderRaw
+            delay 0.2
+        end if
+        tell newMessage
+            repeat with addressText in toList
+                if (addressText as text) is not "" then
+                    make new to recipient at end of to recipients with properties {address:addressText as text}
+                end if
+            end repeat
+            repeat with addressText in ccList
+                if (addressText as text) is not "" then
+                    make new cc recipient at end of cc recipients with properties {address:addressText as text}
+                end if
+            end repeat
+            repeat with addressText in bccList
+                if (addressText as text) is not "" then
+                    make new bcc recipient at end of bcc recipients with properties {address:addressText as text}
+                end if
+            end repeat
+            repeat with attachmentPath in attachmentList
+                if (attachmentPath as text) is not "" then
+                    make new attachment with properties {file name:(POSIX file (attachmentPath as text))} at after the last paragraph
+                end if
+            end repeat
+        end tell
+    end tell
+
+    if senderRaw is not "" then
+        set resolvedAccountLabel to my sanitizeText(my selectSenderPopup(senderRaw, senderEmail))
+    end if
+
+    tell application "Mail"
+        return my sanitizeText((id of newMessage) as text) & fieldSeparator & my boolText(visible of newMessage) & fieldSeparator & resolvedAccountLabel & recordSeparator
+    end tell
+end run

apple_mcp_mail-1.0.1/src/apple_mail_mcp/applescripts/delete_message.applescript

@@ -0,0 +1,54 @@
+on boolText(flagValue)
+    if flagValue then
+        return "true"
+    end if
+    return "false"
+end boolText
+
+on run argv
+    set accountName to item 1 of argv
+    set mailboxName to item 2 of argv
+    set appleId to item 3 of argv
+
+    set fieldSeparator to ASCII character 31
+    set recordSeparator to ASCII character 30
+
+    tell application "Mail"
+        set targetAccount to missing value
+        repeat with theAccount in every account
+            if (name of theAccount) is accountName then
+                set targetAccount to theAccount
+                exit repeat
+            end if
+        end repeat
+        if targetAccount is missing value then
+            error "ACCOUNT_NOT_FOUND"
+        end if
+
+        set targetMailbox to missing value
+        repeat with theMailbox in every mailbox of targetAccount
+            if (name of theMailbox) is mailboxName then
+                set targetMailbox to theMailbox
+                exit repeat
+            end if
+        end repeat
+        if targetMailbox is missing value then
+            error "MAILBOX_NOT_FOUND"
+        end if
+
+        set targetMessage to missing value
+        repeat with theMessage in messages of targetMailbox
+            if ((id of theMessage) as text) is appleId then
+                set targetMessage to theMessage
+                exit repeat
+            end if
+        end repeat
+        if targetMessage is missing value then
+            error "MESSAGE_NOT_FOUND"
+        end if
+
+        delete targetMessage
+
+        return my boolText(true) & recordSeparator
+    end tell
+end run