Supyagent
Getting Started

What is Supyagent?

Supyagent gives your AI tools access to your apps — Gmail, Slack, Calendar, GitHub, and more.

What is Supyagent?

Supyagent connects your AI coding tools to the apps you already use — Gmail, Slack, Google Calendar, GitHub, and more. You connect your accounts once on a dashboard, and then any AI tool that supports it can read your emails, send Slack messages, check your calendar, and more.

No API keys to juggle. No OAuth flows to build. Just connect and go.

How it works

┌─────────────────────────────────────────────────────────────┐
│                                                             │
│   You                                                       │
│    │                                                        │
│    ├── 1. Sign up at supyagent.com                          │
│    │      Connect Gmail, Slack, Calendar, etc.              │
│    │      Get your API key                                  │
│    │                                                        │
│    ├── 2. Install the CLI                                   │
│    │      pip install supyagent                              │
│    │      supyagent connect                                 │
│    │                                                        │
│    └── 3. Use it                                            │
│           ┌──────────────────────────────────────────┐      │
│           │  Option A: CLI                           │      │
│           │  supyagent service run gmail_list_messages│      │
│           ├──────────────────────────────────────────┤      │
│           │  Option B: Node SDK                      │      │
│           │  const supyagent = new Supyagent(key)    │      │
│           ├──────────────────────────────────────────┤      │
│           │  Option C: IDE Skills                    │      │
│           │  supyagent skills generate               │      │
│           │  → Claude Code, Cursor, Codex, etc.      │      │
│           └──────────────────────────────────────────┘      │
│                                                             │
└─────────────────────────────────────────────────────────────┘

Three ways to use Supyagent

CLI

Run cloud tools directly from your terminal. Great for testing and scripting.

# List your recent emails
supyagent service run gmail_list_messages '{}'

# Send a Slack message
supyagent service run slack_send_message '{"channel": "#general", "text": "Hello from supyagent!"}'

# Check your calendar
supyagent service run calendar_list_events '{"timeMin": "2026-02-25T00:00:00Z"}'

Node SDK

Use @supyagent/sdk in your TypeScript/JavaScript apps to call the same tools programmatically.

example.ts
import { Supyagent } from "@supyagent/sdk";

const supyagent = new Supyagent({ apiKey: "sk_live_..." });
const emails = await supyagent.run("gmail_list_messages", { max_results: 5 });

IDE Skills

Generate skill files that teach your AI coding assistant (Claude Code, Cursor, Codex) how to use your connected integrations. Your AI can then read emails, check Slack, create calendar events, and more — all inside your IDE.

supyagent skills generate
# Writes skill files to .claude/skills/, .cursor/skills/, etc.

What integrations are supported?

ProviderWhat you can do
Google (Gmail, Calendar, Drive, Docs, Sheets, Slides)Read/send emails, manage events, read/write files and documents
SlackRead/send messages, list channels and users
GitHubManage issues, PRs, repos
DiscordSend messages, manage channels
Microsoft (Outlook, Calendar, OneDrive)Email, calendar, file storage
NotionRead/write pages and databases
TelegramSend/receive messages
HubSpotManage contacts and companies
LinearManage issues, projects, teams
WhatsAppSend messages
PipedriveManage deals
CalendlyView event types and scheduled events

Ready to start?

The next few pages will walk you through everything:

  1. Create Your Account — Sign up and connect your first integration
  2. Install the CLI — Get the supyagent command on your machine
  3. Connect Your Account — Link your CLI to your dashboard account
  4. Your First API Call — Run a cloud tool and see the result
  5. Generate Skills for Your IDE — Set up AI coding assistant integration

Or jump straight to a quickstart:

IDE quickstarts — Add cloud integrations to your AI coding assistant:

Build your own agent — Ship a full chatbot app with all batteries included: