Skip to content
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
15 changes: 15 additions & 0 deletions .cursor-plugin/marketplace.json
Original file line number Diff line number Diff line change
Expand Up @@ -32,6 +32,21 @@
"name": "ralph-loop",
"source": "ralph-loop",
"description": "Iterative self-referential AI loops using the Ralph Wiggum technique."
},
{
"name": "gmail",
"source": "gmail",
"description": "Daily Gmail triage workflows with follow-up scheduling in Calendar."
},
{
"name": "google-drive",
"source": "google-drive",
"description": "Publish Drive release artifacts with controlled sharing and Chat announcements."
},
{
"name": "google-calendar",
"source": "google-calendar",
"description": "Build meeting briefs from Calendar events with related Gmail and Drive context."
}
]
}
3 changes: 3 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,6 +11,9 @@ Official Cursor plugins for popular developer tools, frameworks, and SaaS produc
| [Cursor Team Kit](cursor-team-kit/) | Developer Tools | Internal-style workflows for CI, code review, shipping, and testing |
| [Create Plugin](create-plugin/) | Developer Tools | Meta workflows for creating Cursor plugins with scaffolding and submission checks |
| [Ralph Loop](ralph-loop/) | Developer Tools | Iterative self-referential AI loops using the Ralph Wiggum technique |
| [Gmail](gmail/) | Productivity | Daily Gmail triage workflows with follow-up scheduling in Calendar |
| [Google Drive](google-drive/) | Productivity | Publish Drive release artifacts with controlled sharing and Chat announcements |
| [Google Calendar](google-calendar/) | Productivity | Build meeting briefs from Calendar events with related Gmail and Drive context |

## Repository structure

Expand Down
30 changes: 30 additions & 0 deletions gmail/.cursor-plugin/plugin.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,30 @@
{
"name": "gmail",
"displayName": "Gmail",
"version": "1.0.0",
"description": "Daily inbox triage workflows for Gmail with optional follow-up scheduling in Calendar.",
"author": {
"name": "Cursor",
"email": "plugins@cursor.com"
},
"homepage": "https://github.com/cursor/plugins",
"repository": "https://github.com/cursor/plugins",
"license": "MIT",
"logo": "assets/avatar.png",
"keywords": [
"google-workspace",
"gmail",
"triage",
"calendar",
"operations"
],
"category": "productivity",
"tags": [
"gmail",
"triage",
"email-ops"
],
"skills": "./skills/",
"agents": "./agents/",
"mcpServers": "./mcp.json"
}
21 changes: 21 additions & 0 deletions gmail/LICENSE
Original file line number Diff line number Diff line change
@@ -0,0 +1,21 @@
MIT License

Copyright (c) 2026 Cursor

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
45 changes: 45 additions & 0 deletions gmail/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,45 @@
# Gmail

Use-case specific plugin for daily Gmail inbox triage with optional Calendar follow-up scheduling.

## Installation

```bash
/add-plugin gmail
```

## What this plugin includes

- A focused triage skill: `daily-inbox-triage`
- A dedicated operator agent: `inbox-operations-lead`
- Scoped MCP server config for Gmail + Calendar: `gws mcp -s gmail,calendar -w -e`

## Setup

1. Install Google Workspace CLI:
```bash
npm install -g @googleworkspace/cli
```
2. Authenticate:
```bash
gws auth setup
```
3. Ensure `gws` is on your `PATH`.

Optional: add upstream API-specific skills:

```bash
npx skills add https://github.com/googleworkspace/cli/tree/main/skills/gws-gmail
npx skills add https://github.com/googleworkspace/cli/tree/main/skills/gws-calendar
```

## Typical flow

1. Ask the agent to run inbox triage for a specific window.
2. Review proposed label/archive decisions.
3. Confirm follow-up event creation for high-priority threads.
4. Receive a triage summary and unresolved items list.

## License

MIT
28 changes: 28 additions & 0 deletions gmail/agents/inbox-operations-lead.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,28 @@
---
name: inbox-operations-lead
description: Inbox triage specialist for Gmail operations and follow-up scheduling. Use when users need fast mailbox cleanup and action extraction.
model: fast
---

# Inbox operations lead

Focused Gmail operations agent for high-volume triage and action capture.

## Trigger

Use for backlog cleanup, urgent-thread extraction, and converting actionable threads into calendar follow-ups.

## Workflow

1. Determine triage scope (time window, labels, senders, priorities).
2. Pull message candidates and inspect details in bounded batches.
3. Classify and apply label/archive decisions.
4. Create follow-up events for actionable items.
5. Return a concise action report with unresolved risks.

## Output

- Message counts by action
- Labels added/removed
- Follow-up events created
- Remaining manual decisions
14 changes: 14 additions & 0 deletions gmail/mcp.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,14 @@
{
"mcpServers": {
"gmail": {
"command": "gws",
"args": [
"mcp",
"-s",
"gmail,calendar",
"-w",
"-e"
]
}
}
}
48 changes: 48 additions & 0 deletions gmail/skills/daily-inbox-triage/SKILL.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,48 @@
---
name: daily-inbox-triage
description: Run a repeatable Gmail triage routine, then schedule follow-ups in Calendar for actionable threads.
---

# Daily inbox triage

## Trigger

Use when a user asks to clean up inbox backlog, prioritize urgent mail, and convert important threads into calendar actions.

## Required inputs

- Mailbox user ID (typically `me`)
- Time window (for example, last 24h or last 7d)
- Priority criteria (sender domains, keywords, existing labels)
- Optional follow-up window for scheduling (for example, next 2 business days)

## Workflow

1. Confirm authentication is available (`gws auth login` if needed).
2. List candidate messages with a bounded query and page size.
3. Fetch full message metadata for the shortlisted message IDs.
4. Classify messages into: archive, needs reply, delegate, or schedule follow-up.
5. Apply Gmail label updates in batches.
6. For schedule follow-up items, create short Calendar events with links back to the message threads.
7. Produce a compact triage summary with counts and the highest priority unresolved threads.

## Tooling

- Prefer `gws mcp -s gmail,calendar -w -e` tools when MCP is available.
- Use direct CLI commands only when MCP access is not configured.
- If additional API-specific methods are needed, install upstream skills:
- `npx skills add https://github.com/googleworkspace/cli/tree/main/skills/gws-gmail`
- `npx skills add https://github.com/googleworkspace/cli/tree/main/skills/gws-calendar`

## Guardrails

- Never delete mail unless explicitly requested.
- Use narrow queries first; avoid full-mailbox scans by default.
- For label changes on more than 100 messages, confirm before applying.
- Include timezone when creating calendar follow-up events.

## Output

- Triage totals by action type
- List of created follow-up events
- Remaining high-priority threads needing user attention
30 changes: 30 additions & 0 deletions google-calendar/.cursor-plugin/plugin.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,30 @@
{
"name": "google-calendar",
"displayName": "Google Calendar",
"version": "1.0.0",
"description": "Prepare meeting briefs from Calendar events using Drive and Gmail context.",
"author": {
"name": "Cursor",
"email": "plugins@cursor.com"
},
"homepage": "https://github.com/cursor/plugins",
"repository": "https://github.com/cursor/plugins",
"license": "MIT",
"logo": "assets/avatar.png",
"keywords": [
"google-workspace",
"calendar",
"gmail",
"drive",
"meetings"
],
"category": "productivity",
"tags": [
"calendar",
"meeting-prep",
"briefing"
],
"skills": "./skills/",
"agents": "./agents/",
"mcpServers": "./mcp.json"
}
21 changes: 21 additions & 0 deletions google-calendar/LICENSE
Original file line number Diff line number Diff line change
@@ -0,0 +1,21 @@
MIT License

Copyright (c) 2026 Cursor

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
46 changes: 46 additions & 0 deletions google-calendar/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,46 @@
# Google Calendar

Use-case specific plugin for preparing meeting briefs from Calendar events, related Gmail threads, and Drive docs.

## Installation

```bash
/add-plugin google-calendar
```

## What this plugin includes

- A meeting-prep skill: `prepare-meeting-brief`
- A dedicated briefing agent: `meeting-briefing-pilot`
- Scoped MCP server config for Calendar + Drive + Gmail: `gws mcp -s calendar,drive,gmail -w -e`

## Setup

1. Install Google Workspace CLI:
```bash
npm install -g @googleworkspace/cli
```
2. Authenticate:
```bash
gws auth setup
```
3. Ensure `gws` is on your `PATH`.

Optional upstream skills:

```bash
npx skills add https://github.com/googleworkspace/cli/tree/main/skills/gws-calendar
npx skills add https://github.com/googleworkspace/cli/tree/main/skills/gws-drive
npx skills add https://github.com/googleworkspace/cli/tree/main/skills/gws-gmail
```

## Typical flow

1. Select a meeting window and target calendar.
2. Build briefs for meetings that match selection criteria.
3. Review unresolved questions and prep actions.
4. Optionally save briefs to Drive.

## License

MIT
26 changes: 26 additions & 0 deletions google-calendar/agents/meeting-briefing-pilot.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,26 @@
---
name: meeting-briefing-pilot
description: Build high-signal meeting briefs by combining Calendar event data with Gmail and Drive context.
model: fast
---

# Meeting briefing pilot

Meeting-prep specialist for synthesizing pre-read context from Google Workspace sources.

## Trigger

Use when users need prep briefs for upcoming internal or external meetings.

## Workflow

1. Gather meetings in scope.
2. Pull related email and document context.
3. Summarize into a practical brief with open decisions.
4. Save/share brief if requested.

## Output

- Brief per selected meeting
- Linked source artifacts
- Critical unknowns before meeting start
14 changes: 14 additions & 0 deletions google-calendar/mcp.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,14 @@
{
"mcpServers": {
"google-calendar": {
"command": "gws",
"args": [
"mcp",
"-s",
"calendar,drive,gmail",
"-w",
"-e"
]
}
}
}
Loading