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 or Windows. 
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

Step 1 — Install extension

Download the extension file and double-click it to install it in Claude Desktop.

Alternatively, in Claude Desktop, go to Settings > Extensions, click Advanced settings, then Install, and choose the downloaded file.

Step 2 — Install Spark skill

Teach Claude how to work with Spark.

Download the Spark skill file and double-click it to install it in Claude Desktop.

Alternatively, in Claude Desktop, go to Customize > Add > Upload Skill, and choose the downloaded file.

Step 3 — Install personas and recipes (optional)

Optional skills that tailor Claude to specific roles and workflows. Download the ones you need and double-click each to install (or add them from Customize > Add > Upload Skill).

Personas

Exec Assistant — Summarizes your day, drafts replies, organizes your schedule
Founder — Sorts a busy inbox fast and assigns the rest
Freelancer — Manages multiple clients, follows up on invoices, replies fast
Meeting Manager — Prepares for meetings, reviews notes, drafts follow-ups
Project Manager — Connects project threads, shares updates, finds action items
Sales Rep — Tracks deals and keeps follow-ups on schedule
Support Agent — Handles Shared Inboxes, assigns items, drafts templated replies
Team Lead — Reviews team workload, balances assignments, checks Shared Inboxes

Recipes

Calendar Audit — Reviews your meeting load and finds free time
Delegate and Track — Assigns emails to teammates and checks progress
Draft Batch — Finalizes pending drafts, presents them for review and action
End of Day — Checks open items and previews tomorrow's schedule
Inbox by Category — Reviews your inbox based on Spark's categories
Inbox Zero — Processes your inbox, category by category
Invitation Manager — Matches invitations to your calendar and recommends replies
Label Organize — Organizes emails into the right labels and folders
Meeting Follow-Up — Drafts follow-up emails from meeting transcripts
Meeting Prep — Gathers emails and attendee details before a meeting
Morning Standup — Starts your day with events, unread mail, and assignments
Multi-Account Review — Reports inbox status across all your accounts
New Sender Review — Screens new senders so you can accept or block them
Newsletter Cleanup — Blocks or unsubscribes from unwanted newsletters
Notification Hygiene — Reduces notification noise and removes old alerts
Priority Tuning — Adjusts which contacts appear as Priority
Schedule Meeting — Finds times when everyone is available
Shared Inbox Status — Shows open, done, and unassigned items in Shared Inboxes
Shared Inbox Triage — Resolves open items in Shared Inboxes
Stakeholder Brief — Organizes history with one person into a brief
Team Workload — Compares assignment loads across your team
Topic Timeline — Builds a timeline of meetings and emails on one topic
Unsubscribe Audit — Scans every newsletter and suggests what to unsubscribe from
Vacation Catchup — Clears your email backlog after time away
Weekly Digest — Creates a weekly summary of meetings, emails, and team status

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/on my PC — 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

Step 1 — Install the Spark plugin
In Cursor, open Settings > Plugins, paste this link into the "Search or Paste Link" field, and click Install.

Codex

Step 1 — Add the Spark marketplace

In Codex, open Plugins > Add marketplace, paste this link, and confirm.

Step 2 — Install the Spark plugin

In Codex, open Plugins, find Spark in the available plugins, and install it.

Codex has three permission levels:

• Ask for approval — always ask to edit external files and use the internet
• Approve for me — only ask for actions detected as potentially
• Full Access — unrestricted access to the internet and any file on your computer

Most likely, you are using the Ask for approval 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 Ask for approval 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/on my PC — 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/on my PC — 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/on my PC — 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.