Set up Spark CLI with your AI Agents

Your AI agent can read your inbox, calendar, and meeting notes directly through Spark Desktop. Here's how to connect it.

Step 1: Enable Spark CLI

1. Launch Spark Desktop on your Mac. 
2. Go to Settings > AI Agents. 
3. Under Connect AI Agents, click Setup CLI.

Step 2: Configure account access

Choose which email accounts your agent can access and the level of access for each.

• Off: your agent cannot see this account.
• On: your agent can view emails, contacts, and calendars for this account.

You can enable or disable access to meeting notes separately.

You can also change these settings at any time.

Step 3: Enable semantic search

Semantic search finds contextually relevant results, not just exact keyword matches. It runs on Spark's local index, which understands priorities, categories, and conversation context — so your agent can surface the right information with less manual filtering.

To enable it:

1. Open Spark Settings.
2. Go to Spark +AI > AI Assistant.
3. Toggle AI Assistant on.

This is a one-time action and does not consume any AI tokens. Semantic indexing runs locally on your device.

Semantic search history depends on your plan: 1 month on Free, 1 year on Plus, unlimited on Pro.

Step 4: Connect to your agent platform

Spark CLI works with any agent platform that supports command-line tools or local MCP connectors.

Claude Cowork

1. Go to Settings > Extensions. 
2. Click on Advanced settings and then on Install, and choose the extension file.

Claude Code

Copy this prompt and paste it into Claude Code to teach it about Spark:

Hi! I just installed Spark CLI on my Mac — it's a command-line interface for my Spark app. Please run 'spark skill' to see what I can do, then install the skill.

Add Spark as a local MCP server in Claude Code settings: 

1. Open Claude Code. 
2. Start a new conversation or session. 
3. Paste the prompt above. 
4. Claude will discover Spark tools automatically. 

Cursor

Copy this prompt and paste it into the Cursor to teach it about Spark:

Hi! I just installed Spark CLI on my Mac — it's a command-line interface for my Spark app. Please run 'spark skill' to see what I can do, then install the skill.

1. Open Cursor. 
2. Start a new conversation or session. 
3. Paste the prompt above. 
4. Cursor will discover Spark tools automatically. 

Codex

Copy this prompt and paste it into Codex to teach it about Spark:

Hi! I just installed Spark CLI on my Mac — it's a command-line interface for my Spark app. Please run 'spark skill' to see what I can do, then install the skill.

1. Open Codex. 
2. Start a new conversation or session. 
3. Paste the prompt above. 
4. Codex will discover Spark tools automatically.

Codex has three permission levels:

• Default — tries to run all commands in the sandbox
• Auto-Review — asks you whether you want to run a command outside the sandbox
• Full Access — runs everything outside the sandbox

Most likely, you are using the Default level. You can change these permission levels, but an even better option is to add Spark to the exclude list.

Codex has functionality for a list of auto-approved commands. There is no UI to configure this list, but you can ask Codex in chat to add Spark to the auto-approved list.
With this configuration, Spark will be accessible even with the Default permission level.

Google Antigravity

Copy this prompt and paste it into Google Antigravity to teach it about Spark:

Hi! I just installed Spark CLI on my Mac — it's a command-line interface for my Spark app. Please run 'spark skill' to see what I can do, then install the skill.

1. Open Google Antigravity. 
2. Start a new conversation or session. 
3. Paste the prompt above. 
4. Google Antigravity will discover Spark tools automatically. 

OpenClaw

Copy this prompt and paste it into OpenClaw to teach it about Spark:

Hi! I just installed Spark CLI on my Mac — it's a command-line interface for my Spark app. Please run 'spark skill' to see what I can do, then install the skill.

1. Open OpenClaw. 
2. Start a new conversation or session. 
3. Paste the prompt above. 
4. OpenClaw will discover Spark tools automatically. 

Hermes Agent

Copy this prompt and paste it into Hermes Agent to teach it about Spark:

Hi! I just installed Spark CLI on my Mac — it's a command-line interface for my Spark app. Please run 'spark skill' to see what I can do, then install the skill.

1. Open Hermes Agent. 
2. Start a new conversation or session. 
3. Paste the prompt above. 
4. Hermes Agent will automatically discover Spark tools.