Tools

The main voice agent has 13 built-in tools. They cover connected apps, the live web, your browser and Mac, Apple Reminders, mrmr itself, scripts, background sub-agents, and the voice session. A background sub-agent has a smaller set of four online tools.

You do not need to say a tool name or use special command syntax. State the result you want, such as “Find the launch plan in my browser history,” “Pause my music,” or “Research this company in the background.” mrmr selects and combines the appropriate tools.

Tool summary

The first ten tools provide capabilities you can intentionally request by voice. The final three support connected-app requests automatically; you normally do not ask for them by name.

Main voice agent and sub-agent access

The main voice agent can use every tool on this page. It runs on your Mac, so it can reach local browser data, files and folders, clipboard actions, Apple Reminders, mrmr controls, and trusted scripts in addition to online tools.

A background sub-agent runs in the cloud and can use only:

• find_tool to discover connected-app operations.
• run_tool to read connected apps or propose a write.
• search_workspace to resolve connected-app names and records.
• web_search for current public information.

The sub-agent cannot directly use search_browser, system_tool, reminders_tool, mrmr_app, run_script, render_ui, delegate_to_sub_agent, check_sub_agent, or end_session. If delegated work needs local information, the main voice agent must retrieve it first and include it as task context. Any connected-app write proposed by a sub-agent pauses until you approve or reject it in the sub-agent panel.

Tools mrmr uses automatically for integrations

These tools support the connected-app actions documented elsewhere in the manual. They are included here for completeness, but users normally interact with them by asking for an outcome in an app.

find_tool

find_tool discovers the exact operation and required fields for a step involving a connected cloud app. mrmr calls it automatically before reading or acting in Slack, Linear, Google Calendar, Gmail, GitHub, Notion, and other supported integrations.

For example, “Create a Linear issue and post its link in Slack” can cause separate tool searches for creating the issue and sending the message.

See Supported apps and commands for the connected apps and customer-facing actions currently supported.

run_tool

run_tool executes an operation returned by find_tool.

• Reads, such as listing events or searching messages, can run immediately.
• Writes, such as sending, creating, updating, deleting, scheduling, or merging, require approval in a confirmation card.
• Approval is bound to the exact operation and arguments shown. Changed arguments require another confirmation.

You trigger it by asking for an outcome in a connected app: “What is on my calendar tomorrow?” or “Create a GitHub issue for the settings crash.”

search_workspace

search_workspace turns a name you said into the exact connected-app record mrmr needs. It can resolve entities including:

• Slack channels and members.
• Linear teams, projects, users, and issues.
• Calendars, contacts, labels, tasks, and task lists.
• Attio people, companies, deals, and lists.
• Cal.com bookings and schedules.
• GitHub repositories.

mrmr uses this automatically when a request contains a human-readable name instead of an internal ID. If several matches are plausible, it can ask you to choose.

Information and presentation tools

web_search

web_search searches current public information and returns an answer with source links. Use it for news, documentation, prices, companies, products, or anything that may have changed.

Try “Search the web for the latest macOS release notes and summarize the important changes.” Web search is read-only and does not require confirmation.

render_ui

render_ui displays information in the expanded Agent Mode panel. It supports:

• Markdown for longer answers, lists, schedules, code, and tables.
• Choice cards when you need to select one matching person, channel, project, or other option.
• Confirmation cards that show the exact writes awaiting approval.

You can explicitly ask “Show that as a table” or “Put the full answer in the panel.” mrmr also uses this tool automatically when information is easier to read than hear.

Browser and Mac tools

search_browser

search_browser searches data stored by supported Chromium browsers on your Mac, including Chrome, Brave, Edge, and Comet. It can search:

• Bookmarks.
• Browsing history.
• Frequently visited pages.
• Address-bar shortcuts.
• Saved site-search shortcuts.

Try “Open my Google Search Console” or “Find the design document I visited yesterday.” The search is local and read-only. After finding a URL, mrmr can open it with system_tool.

system_tool

system_tool provides these on-device actions:

Examples include “Pause my music,” “Set the volume to 30 percent,” “Open Figma,” “Find the Q3 forecast in Downloads,” and “Paste that into the current app.”

File search matches names rather than file contents. The tool can list folders and open documents, but it does not read arbitrary local file contents into the conversation. These actions do not use the connected-app confirmation card.

reminders_tool

reminders_tool works with Apple Reminders after you connect the local integration and grant macOS permission. It can:

• Create a reminder with optional notes, due date, and list.
• List reminders, optionally filtering by list or completion state.
• Update a reminder’s title, notes, due date, or completion state.
• Delete a reminder.
• Create a reminder list.
• Delete a reminder list.

Try “Remind me to submit expenses Friday at 4,” “What is left on my Work list?” or “Mark buy printer ink complete.” mrmr asks before deleting an entire list because that also removes its reminders.

mrmr and automation tools

mrmr_app

mrmr_app controls mrmr itself. It can:

• Open Home, Transcripts, Dictionary, Integrations, Agents, Scripts, General, Voice, Privacy, or About.
• List available and connected integrations.
• Start connecting a cloud integration or Apple Reminders.
• Disconnect an integration after confirmation.
• List or search personal dictionary entries.
• Add a dictionary term with an optional replacement.
• Remove a dictionary term.
• Send feedback to the mrmr team after reading it back and receiving confirmation.

Try “Open Privacy settings,” “Connect GitHub,” or “Add Kubernetes to my dictionary.”

run_script

run_script launches one of the scripts already present in your Agent Folder. mrmr can fill declared text, dropdown, or file arguments from your request and can pass results between scripts and other tools.

• mrmr never invents or writes a script through this tool.
• Imported scripts must be reviewed and trusted before they can run.
• Inactive scripts require your agreement before they are reactivated.
• A script can be configured to require confirmation.
• Output can be spoken, shown, copied, pasted, opened, ignored, or passed into another step according to the script’s configuration and your request.

Try “Run my standup script for the mobile team.” See Scripts for setup and safety details.

Background work

delegate_to_sub_agent

delegate_to_sub_agent starts a self-contained, multi-step task that continues in the background while you keep using Agent Mode. It is intended for research, gathering, comparison, summarization, and work that requires several connected-app or web lookups.

Try “In the background, summarize this week’s engineering Slack discussions and my open Linear issues.”

A sub-agent can use connected cloud apps, workspace search, and web search. It cannot directly use local files, your clipboard, browser data, Apple Reminders, or other on-device tools. mrmr can first retrieve local information and pass that text into the delegated task. Any cloud write pauses for your approval.

check_sub_agent

check_sub_agent retrieves the state of delegated work. Ask “Is that background task finished?” or “What did the research agent find?” It can report that the task is queued, working, waiting for approval, finished, or failed, and returns the result when available.

See Sub-agents for the complete workflow.

Session control

end_session

end_session closes Agent Mode after the spoken response finishes. Say “That’s all,” “Goodbye,” or another clear ending. Silence alone does not end the session, and mrmr does not call this tool while a normal request is still in progress.

Safety and availability

• Cloud writes performed through run_tool require approval.
• Background sub-agent writes pause and wait for approval.
• Disconnecting an integration and sending feedback require confirmation.
• Deleting an Apple Reminders list requires confirmation.
• Scripts follow their individual trust, activation, and confirmation settings.
• Read-only searches and supported on-device actions run immediately.
• Connected-app availability depends on the apps you connect, granted permissions, provider plan, and provider API support.

Open Agents → Agent Runs after a conversation to see which tools were used.