Use your own API key
Mindswept can use a key from OpenRouter, Anthropic or OpenAI. Your provider bills you for what the agent uses, and Mindswept charges nothing. It takes about a minute.
Before you start
You need an account with one of the three providers, with billing set up there:
- OpenRouter: one key, many models.
- Anthropic: Claude models, billed to your Anthropic API account.
- OpenAI: OpenAI models, billed to your OpenAI API account. Web research does not work with an OpenAI key yet.
An API account is separate from a Claude or ChatGPT subscription. If you have a subscription and no API account, local MCP access may suit you better.
Set a spending limit on the key with your provider. Mindswept can't cap a key it doesn't manage.
Steps
-
Open the AI access choice
On the Mac, open Settings in the sidebar, find AI access under Model, cost and data, and click Change…. On the iPhone, open the Now tab, tap More, then Settings, then Change… under AI access. The first time, the button reads Set up AI access… instead.
-
Choose Your own API key
Select the card and continue, then pick your provider.
-
Add the key
With OpenRouter you can click Connect OpenRouter…. It opens openrouter.ai so you can approve Mindswept, and a key made for Mindswept comes back by itself with nothing to copy.
Otherwise, create a key on the provider's site, paste it into the field and click Check key. Each provider's screen has a link to the page where keys are made.
-
Wait for the check
Mindswept makes one free request to confirm the key. When it reads "Key works. Saved to Keychain." you are done.
-
Do the same on your other device
Keys are not synced. Your iPhone and your Mac each need the key entered once. The choice of provider does sync.
Choosing a model
On the Mac, Settings shows two model choices under Model, cost and data once a key is active. The main model handles sessions, chat, planning and research. The quick model, called the background model with OpenRouter, handles Now's pick and chat summaries. The defaults are Claude Opus 5.5 and Claude Haiku 5.5 with Anthropic and OpenRouter, and OpenAI's current models with an OpenAI key. The iPhone uses whatever you chose on the Mac.
Where your data goes
Requests go straight from your device to the provider, under your own account with them. They do not pass through Mindswept. With OpenRouter, the text also goes on to the model provider OpenRouter routes to. The key is stored in the Keychain on each device. The privacy policy lists what a request can contain.
If it doesn't work
- "didn't accept this key": the key is wrong, revoked or from a different provider. Create a new one and paste it again.
- "Couldn't reach" the provider: check your connection and try again.
- "Not enough credit with the provider": add credit or a payment method in your provider account.
- "The provider's usage limit for this key is reached": raise the limit with the provider, or wait.
- "The provider is rate-limiting requests": try again in a minute.
- "No key on this device yet": you added the key on your other device. Add it here too.
Still stuck? Write to me.