Provider API and Staged Scans
SkillDatabases & dataLets your agent call raw Gmail, Google Calendar, and HubSpot APIs directly and handle large email searches.
Available today. Use it from your connected AI after setup.
No other account needed.
Add ahel to your AI once: Claude, ChatGPT, Cursor, Claude Code or Codex. Then ask it to use this.
Then ask your AI: use the Provider API and Staged Scans skill
About this skill
Call raw Gmail, Google Calendar, or HubSpot endpoints through provider-api-catalog / provider-api-docs / provider-api-request, and stage large result sets with stageAs plus query-staged-dataset. Use when a canned Mail action lacks the exact endpoint, filter, pagination, or API version, or when scann
What this skill tells your AI
The instructions your AI receives, as published by builderio/agent-native in templates/mail/.agents/skills/provider-api-scans/SKILL.md and read by ahel’s review.
Rule
Treat provider-specific actions as shortcuts, not capability limits. When the
exact Gmail, Google Calendar, or HubSpot endpoint/filter/pagination/API
version matters, use provider-api-catalog, provider-api-docs, and
provider-api-request against the real provider API.
Staging large scans
For large scans, stage results with stageAs and analyze them with
query-staged-dataset (list-staged-datasets / delete-staged-dataset
manage the scratch rows). Staging keeps big provider payloads out of the
conversation: pass ids, counts, and bounded summaries instead of pasting raw
dumps.
What Mail can reach
Mail's catalog resolves to gmail, google_calendar, and hubspot only
(MAIL_PROVIDER_API_IDS / listProviderApiIdsForTemplateUse("mail") in
server/lib/provider-api.ts). Gong, Pylon, and Apollo are not reachable
through provider-api-request in this app — see contacts-and-crm.
Related Skills
contacts-and-crm— which CRM providers are agent-reachable in Mail.inbox-reads-and-triage— prefer the canned read actions when they already express the query.
Signals
- GitHub stars
- 7k
- Forks
- 613
- Last commit
- Sep 2026
Advanced
- Item type
- skill
- Key
provider-api-scans- Source
- github.com/builderio/agent-native