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
- Launch Spark Desktop on your Mac or Windows.
- Go to Settings > AI Agents.
- 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
- Read: your agent can view emails, contacts, and calendars for this account
- Triage: your agent can draft replies and organize messages in your Inbox
- Send: your agent can send emails on your behalf
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:
- Open Spark Settings.
- Go to Spark +AI > AI Assistant.
- 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
- Download the Spark plugin.
- In Claude Desktop, open Customize > Plugins.
- Click Add, then Upload plugin.
- Select the downloaded spark-plugin.zip from your Downloads folder.

Claude Code
Install Spark skills - it copies Spark's skills into Claude Code's own skills folder, so it knows how to work with your mail, calendar, and contacts.
Cursor
Install Spark skills - it copies Spark's skills into Cursor's own skills folder, so it knows how to work with your mail, calendar, and contacts.
Codex
Install Spark skills - it copies Spark's skills into Codex's own skills folder, so it knows how to work with your mail, calendar, and contacts.
Google Antigravity
Install Spark skills - it copies Spark's skills into Google Antigravity's own skills folder, so it knows how to work with your mail, calendar, and contacts.
OpenClaw
Install Spark skills - it copies Spark's skills into OpenClaw's own skills folder, so it knows how to work with your mail, calendar, and contacts.
Hermes Agent
Install Spark skills - it copies Spark's skills into Hermes Agent's own skills folder, so it knows how to work with your mail, calendar, and contacts.
Grok Bot
Copy and paste this prompt into the new conversation:
Please install the Spark skills from https://github.com/readdle/spark-cli-skills as your private skills: add every folder under skills/ and keep each SKILL.md unchanged. They teach you to use Spark CLI, the `spark` command on my computer, to work with my email, calendar, contacts and meeting notes. When you're done, run `spark --help` on my computer to check that it answers.