Skip to content

mugwork/mug-connectors

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 

Repository files navigation

Mug Connectors

Mug Connectors

Ready-to-use API connectors for Mug workspaces. Sync data from external platforms into your workspace's local SQLite database, and push changes back via workflow actions.

Usage

Search and clone connectors from the catalog with the Mug CLI Agent Kit:

# Search for a connector
mug connector search "hubspot"

# Clone it into your workspace (downloads spec + scaffolds connector file)
mug connector clone --slug hubspot

# Set your API credentials
mug secret set HUBSPOT_BEARER_TOKEN=your-token-here

# Sync data
mug dev
curl -X POST http://localhost:8787/sync/hubspot

Or run the Mug CLI Agent Kit's bundled /connect skill to have Claude Code, Codex, or Cursor search the catalog automatically before building from scratch.

Connectors

Connector Platform Auth Tables Actions Quality
airtable Airtable bearer 1 3 deploy-only
asana Asana bearer 6 9 deploy-only
basecamp Basecamp oauth2 2 4 deploy-only
clickup ClickUp bearer 1 6 deploy-only
coda Coda bearer 1 3 deploy-only
google-sheets Google Sheets oauth2 0 3 deploy-only
hubspot HubSpot bearer 5 15 deploy-only
monday Monday bearer 1 3 deploy-only
notion Notion bearer 4 7 deploy-only
salesforce Salesforce oauth2 6 15 deploy-only
servicetitan ServiceTitan bearer 0 2 deploy-only
slack Slack bearer 5 deploy-only
smartsheet Smartsheet bearer 3 3 deploy-only
smartsuite SmartSuite bearer 2 4 deploy-only
softr Softr bearer 1 3 deploy-only
supabase Supabase bearer 0 4 deploy-only
trello Trello api-key 2 3 deploy-only
zite Zite bearer 1 3 deploy-only

How it works

Each connector contains:

  • meta.yaml — API metadata: auth type, rate limits, docs URL
  • openapi.yaml — OpenAPI 3.0 spec with x-mug-* annotations for pagination, rate limits, and incremental sync

When you run mug connector clone, the CLI downloads these specs and scaffolds a TypeScript connector file (connectors/<slug>.ts) tailored to your workspace. The spec is the recipe — your AI coding agent customizes the output for your specific tables and fields.

Quality tiers

  • verified-sync — tested against a live API with real credentials
  • deploy-only — spec written from API documentation, not yet verified against a live API

Contributing

This connector catalog is automatically crowdsourced from all deployed Mug workspaces. When a workspace deploys, its connector specs are programatically compared to the catalog and auto merged/published with richer specs winning out. Keep in mind this is connector spec information only — not sensitive connector configuration metadata.