Spark for Raycast brings your inbox, calendar, contacts, and meeting notes into Raycast. You can triage mail, search, check your agenda, find a free slot, and draft emails without switching windows. You can also ask Raycast AI about your mail, calendar, and meetings with Spark.
Jump to:

Before you start
Make sure you have:
- Spark Desktop 3.33 or later installed, running, and signed in to at least one email account.
- Spark CLI enabled in Spark Desktop.
- Raycast 2.11 or later installed on the same computer.
- Raycast AI if you want to use @spark in AI Chat. AI Chat requires a paid Raycast plan. The extension’s commands (Inbox, Search, Agenda, Compose, and the rest) work on Raycast Free.
You don't need an API key, and you don't sign in to Spark inside Raycast. The extension uses the accounts you already have in Spark.
Step 1. Enable Spark CLI in Spark
- Open Spark Settings.
- AI Agents.
- Under Connect AI Agents, click Setup CLI and follow the prompts.
- Set the access level for each account.
The following access levels are available:
- Off: Raycast can't see this account
- Read: browse and search mail, calendar, and contacts
- Triage: also archive, snooze, pin, save drafts
- Send (part of the Triage): also send mail and change your calendar
Read access is available on every Spark plan. Triage and Send are included in the Spark Pro plan.
You can change these settings at any time. Raycast follows the access level you choose for each account, so actions you haven't allowed simply won't be available.
Step 2. Install the extension from the Raycast Store
- Open the Spark extension page in the Raycast Store.
- Find the listing Spark, publisher Spark (sparkmailapp) > Click Install Extension. Alternatively, open Raycast, search for Store, and look for Spark by Spark (sparkmailapp).
- Open Raycast and type spark to see all commands.
If something is missing, for example, Spark isn't running, or Spark CLI is turned off, the extension tells you what to do and opens the right place in Spark.
Commands
Press ⌘K (Ctrl+K on Windows) on any item to see everything you can do with it, along with keyboard shortcuts.
| Command | What it does | Tip |
|---|---|---|
| Show Inbox | Your Unified Inbox by Smart Category: Priority, People, Invitations, Notifications, Newsletters, and more. Reply, archive, snooze, pin, or answer an invitation without opening Spark. | Assign a hotkey to Show Inbox and use it as your quick triage view. |
| Search Mail | Keyword and semantic search across every folder and account. | Narrow results with filters like from:anna, is:unread, or newer_than:7d. |
| Show Folders | Every folder, label, and shared inbox across your accounts, like Spark's sidebar. | Open a shared inbox straight from Raycast to check what's unassigned. |
| Show Agenda | Your events for today, tomorrow, or this week. | Join a call, RSVP, or email all attendees from the event. |
| Find Free Time | Your free slots, or the slots you share with other people. | Add attendees, pick a slot, and turn it into an event in one go. |
| Search Contacts | Look up contacts by name, email, or domain, and change how Spark treats them. | Mark someone as Priority or update GateKeeper and notification settings right from the result. |
| Compose Email | Write a new email from scratch or from one of your templates, then send it or save it as a draft. | Start typing a name to add Spark contacts as recipients. |
| Show Meeting Notes | Summaries, transcripts, and notes from your recorded meetings. | Open the notes from your last call before writing the follow-up. |
Set a hotkey or alias
To open any Spark command from anywhere:
- Select the command in Raycast.
- Press ⌘K (Ctrl+K on Windows).
- Choose Configure Command.
- Set a hotkey or an alias, for example, in for Show Inbox.
Use Spark in Raycast AI
The extension connects Raycast AI to Spark through Spark's local MCP server. In AI Chat, type @spark and ask in your own words:
- @spark what's important in my inbox today?
- @spark when am I free with Anna next week?
- @spark summarize my last meeting with the design team
- @spark draft a reply to the latest email from Bob
Raycast AI asks before it drafts, sends, or changes anything. Reading happens without a prompt.
Spark skills
The extension comes with Spark skills: ready-made workflows that Raycast AI follows step by step. You'll find them under Extension Skills in Raycast's AI settings. Just describe what you want:
- Morning standup: @spark give me my morning briefing for today's meetings, unread mail from people and Priority, and what your team is working on
- Inbox zero: @spark help me get to inbox zero goes through your inbox by category and archives, moves, or marks done as you decide
- Meeting prep: @spark prepare me for my next meeting for the agenda, related emails, attendees, and open threads
- Meeting follow-up: @spark draft follow-ups for my last meeting turns action items from the notes into emails to the attendees
- Newsletter cleanup: @spark clean up my newsletters suggests which to keep, unsubscribe from, or block
- Vacation catch-up: @spark I'm back from vacation, catch me up clears the noise and shows what needs your attention
Raycast AI can also take on a role that fits how you work, such as executive assistant, founder, sales rep, or team lead: @spark act as my executive assistant.
Privacy and Permissions
- The extension's commands run on your computer. Raycast talks to Spark CLI, and Spark CLI talks to Spark Desktop. When you ask @spark in Raycast AI, Raycast AI reads the emails it needs to answer, as with any AI Chat request.”
- When you use @spark in AI Chat, Raycast AI reads the emails, events, or notes it needs to answer, and that content is processed by the AI model you use in Raycast, like any other AI Chat.
- Everything the extension does follows the access levels you set in Spark. Raycast appears in Spark as its own agent, with its own permissions and activity in the Agent Activity section of the Spark Desktop sidebar.
FAQ and Troubleshooting
What should I do if Raycast can't reach Spark?
Make sure Spark Desktop is open. Then check that the Spark CLI is enabled in Settings > AI Agents. The extension shows which step is missing and links to it.
What should I do if Raycast says Spark needs an update?
The extension requires Spark Desktop 3.33 or later. Update Spark Desktop to the latest version and try again.
What if Spark CLI is installed in a different location?
By default, the extension looks for /usr/local/bin/spark on macOS and spark.exe on your PATH on Windows. If yours is somewhere else, open the extension's preferences in Raycast and enter the full path in Spark CLI Path. Run which spark (macOS) or where.exe spark (Windows) in a terminal to find it.
Why don't I see Archive, Snooze, or Compose for an account?
That account is set to Read. Change it to Triage (or Send, to send mail) in Settings > AI Agents.
What if I sent something by mistake?
Spark holds outgoing mail and calendar changes for a minute, so you can Undo them in Spark Desktop.
Why is an account or Shared Inbox missing?
Check that the account is connected in Spark and that its access level isn't Off. Shared Inboxes have their own Shared Accounts access level.
Does the extension work on Windows?
Yes. The extension runs on macOS and Windows.
Does the extension cost anything?
The extension is free. Read access works on every Spark plan; Triage and Send requires Spark Pro.