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 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 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 into your skills directory: 'spark skill --install <your-skills-directory>'

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 into your skills directory: 'spark skill --install <your-skills-directory>'

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

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 into your skills directory: 'spark skill --install <your-skills-directory>'

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 into your skills directory: 'spark skill --install <your-skills-directory>'

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