ArcSolve AI Help

How to connect AI clients to the Mac app and how to disconnect them.

About

ArcSolve AI is a menu bar app for Mac. It lets an AI client you connect use Apple apps on your Mac over MCP.

The app has no built-in AI model or chat. Use a separate MCP client such as Claude Code or Codex.

It requires macOS 27 or later. We are preparing the Mac App Store release. Installation steps will follow at release.

Calendar · Reminders · Contacts · Notes · Mail · Messages · Audio (Voice Memos) · Location · Notifications

Voice Memos reads only the audio files in the Recordings folder you connect. It does not use the Voice Memos database, transcripts, or recordings that exist only in the cloud.

The web collection tool sends requests to addresses you specify and organizes the responses. Target servers may receive your IP address and the request content.

Connect

Before you connect, check your AI client's data transmission, retention, and training policies and its approval settings. Results go to that client, and to its provider if it uses a cloud AI service.

Open ArcSolve AI. It appears in the menu bar.
In the ArcSolve AI Settings window that opens first, read the notice and turn on Allow AI Client Connections.
If macOS asks to allow background activity, click Open Login Items Settings… and allow it.
Under Mac App Permissions, click Allow… only for the features you use. For Voice Memos, choose the Recordings folder with Connect Voice Memos….
From Add to Agent in the menu, choose Claude Code… or Codex…. The first time, allow access to .claude.json or config.toml.
Restart the client session to load the tools.

In the Agent Connections window from Manage Connections…, you can see the registration state and use Add / Reconnect, Remove, and Choose File…. If the configuration file does not exist, finish the client's own setup first.

ArcSolve AI does not ask for confirmation for each command. Your AI client manages execution approvals. While connections are allowed, any program in your macOS account that runs the embedded arcsolve can call the tools within your macOS permissions.

Other clients

For another MCP client, register the values below yourself. Change command to where you installed the app. Do not add --fake for a real connection.

{
  "mcpServers": {
    "arcsolve-ai": {
      "type": "stdio",
      "command": "/Applications/ArcSolve AI.app/Contents/Helpers/arcsolve",
      "args": [
        "mcp"
      ]
    }
  }
}

Each client has its own configuration location and reconnect steps.

Run "/Applications/ArcSolve AI.app/Contents/Helpers/arcsolve" status in Terminal to see the app connection state. A successful connection does not mean every tool has permission or will succeed.

Disconnect

Turn off Allow AI Client Connections. This blocks new personal-app requests and stops the background service.
Click Remove in Manage Connections…, or delete the MCP connection in your client.
Remove Voice Memos folder access with Disconnect under Voice Memos.
Revoke macOS permissions in System Settings → Privacy & Security.

Quit ArcSolve AI closes only the menu. While the background service is on, the tools keep working.

Web collection works independently of the connection setting. After you turn off connections, the web collection tools in an open arcsolve mcp connection and standalone runs (arcsolve collect, arcsolve mcp --network-only) still work. To disconnect completely, delete the MCP connection in your client.

Disconnecting does not undo work already started or recall information already sent. Delete conversations and data kept by an external AI in that service. Deleting the app does not delete the original records in Apple apps.

Troubleshooting

App not found: Check the absolute command path and spaces. Use the arcsolve inside the app.
Cannot connect: Check that the app is running, Allow AI Client Connections is on, and the login item is allowed. Then reconnect the client.
Permission denied: Check the matching Allow in Settings and System Settings → Privacy & Security.
Voice Memos access denied: Connect the Recordings folder again. Paths outside the connected folder and symbolic links do not open.
Result is partial or unknown: Only part of the work ran, or the result is uncertain. Do not run the same work again right away with a new request ID. First check the result in the Apple app.
Tools still work after quitting: Quit ArcSolve AI closes only the menu. Turn off Allow AI Client Connections.

Data

The main app and the background service, which handle Apple app data, have no network entitlement. The app does not send the information it processes to ArcSolve.

See the ArcSolve AI privacy policy for details.

Contact

Email support@arcsolve.ai. Start the subject with [ArcSolve AI].

Include the app version, macOS version, error code, and steps to reproduce with synthetic data. Do not send real personal records, keys, or full logs.