skills.rest
mimikun
mimikunCOMMUNITY
Explore all skills by this author →
𝕏@mimikun_DevGitHub

use-spark

Query Spark email, calendar, contacts, and team data through the spark CLI.

33|1|Updated Jul 24, 2022
Search Tags:#cli#search#email#scheduling#calendar#spark#draft
One-click install
npx skills add https://github.com/mimikun/dotfiles --skill use-spark-mimikun
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: use-spark
Source: https://github.com/mimikun/dotfiles/tree/main/dot_claude/skills/use-spark
Command: npx skills add https://github.com/mimikun/dotfiles --skill use-spark-mimikun

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Accessing your Spark mailbox, calendar, and team data from an AI assistant normally requires manual app navigation. This Skill lets the assistant query emails, threads, events, contacts, and meeting transcripts directly through the spark CLI connected to your running Spark Desktop app. ## Core Features & Use Cases - Email Search and Reading: List, filter, and semantically search emails across all folders and accounts, then read full threads and attachments. - Drafts, Comments, and Actions: Create or edit drafts (including replies, forwards, templates, and shared team drafts), post team comments, and perform triage actions like archive, pin, snooze, and assign. - Calendar and Contacts: List events, create or update meetings with attendees and video links, find free time slots, RSVP to invitations, and search contacts. - Use Case: Ask the assistant to find every email from a client across all folders, summarize the latest thread, and draft a reply that stays attached to the existing conversation. ## Quick Start Ask the assistant to search your Spark inbox for unread emails from this week and summarize the most important thread.

Frequently Asked Questions about use-spark

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I search my Spark emails from the command line?▼

Use spark search with a topic for hybrid keyword and semantic search returning full email bodies, or omit the topic to list emails matching Gmail-style filters across all folders. The spark CLI talks to your running Spark Desktop app over IPC.

How do I create an email draft with the spark CLI?▼

Run spark draft with --to, --subject, and --body flags to create a markdown-bodied draft. Use --reply-to with a message ID to attach it to an existing thread, --template for saved templates, and --attach to include files.

Does the spark CLI work without Spark Desktop running?▼

No. The spark CLI is a thin client that communicates over IPC with the running Spark Desktop app and has no own mailbox or credentials. If Spark Desktop is not running, launch it first; the CLI also fails in sandboxes or containers isolated from the desktop session.

What access levels does Spark require for sending emails?▼

Spark accounts have three access levels: read-only for listing and reading, triage for drafts, comments, and email actions, and send for sending drafts and managing calendar events with attendees. Levels are configured per account in Spark Desktop under Settings, AI Agents.

How do I find free meeting time slots with Spark?▼

Use spark availability to find free time slots, optionally including attendee emails to check shared availability. Combine it with spark events to review existing calendar commitments before scheduling.

Related Skills

Explore More Personal & Entrepreneur Skills→
readdlereaddle
43

spark

Manage Spark Desktop email, calendar, and contacts via the MCP protocol.

Official
Advanced
Wanli-LeeWanli-Lee
1

03_task1

Coordinate meeting scheduling via Gmail and Calendar APIs.

Community
Advanced
brainsforaibrainsforai
1

Meeting Notes

Generate structured meeting notes and track action items by owner and due date.

Official
Intermediate
SillyHippySillyHippy

google-direct-oauth

Connects Google Calendar and Gmail via user-owned OAuth credentials with automatic token refresh.

Community
Intermediate