StackOne plugin for ADK¶
The StackOne ADK Plugin connects your ADK agent to hundreds of providers through StackOne's unified AI Integration gateway. Instead of manually defining tool functions for each API, this plugin dynamically discovers available tools from your connected providers and exposes them as native tools in ADK. It supports Human Resources Information Systems (HRIS), Applicant Tracking Systems (ATS), Customer Relationship Management (CRM), productivity and scheduling tools, and many more integrations.
Use cases¶
-
Sales and Revenue Operations: Build agents that find leads in your CRM (e.g. HubSpot, Salesforce), enrich contact data, draft personalized outreach, and log activity back — all within one conversation.
-
People Operations: Create agents that screen candidates in your ATS (e.g. Greenhouse, Ashby), check availability in your calendar tool (e.g. Google Calendar, Calendly), collect interview scorecards, move applicants through pipeline stages, and automate onboarding into your HRIS (e.g. BambooHR, Workday) — covering the full employee lifecycle without manual intervention.
-
Marketing Automation: Build campaign agents that sync audience segments from your CRM to your email platform (e.g. Mailchimp, Klaviyo), trigger email sequences, and report on engagement metrics across channels.
-
Product Delivery: Create agents that triage incoming feedback from your support tools (e.g. Intercom, Zendesk, Slack), prioritize and create issues in your project management tool (e.g. Linear, Jira), and resolve incidents using insights from an observability platform (e.g. PagerDuty, Datadog) — uniting product research, delivery, and reliability in a single workflow.
Prerequisites¶
- A StackOne account with at least one connected provider
- A StackOne API key from the StackOne Dashboard
- A Gemini API key
Installation¶
Or with uv:
Use with agent¶
Environment variables
Set your API keys as environment variables before running the examples below:
Once STACKONE_API_KEY is set, the plugin automatically reads it and discovers your connected accounts.
import asyncio
from google.adk.agents import Agent
from google.adk.apps import App
from google.adk.runners import InMemoryRunner
from stackone_adk import StackOnePlugin
async def main():
plugin = StackOnePlugin()
# Or scope to a specific account:
# plugin = StackOnePlugin(account_id="YOUR_ACCOUNT_ID")
tools = plugin.get_tools()
print(f"Discovered {len(tools)} tools")
agent = Agent(
model="gemini-2.5-flash",
name="scheduling_agent",
description="Manages scheduling, HR, and CRM through StackOne.",
instruction=(
"You are a helpful assistant powered by StackOne. "
"You help users manage their scheduling, HR, and CRM tasks "
"by using the available tools.\n\n"
"Always be helpful and provide clear, organized responses."
),
tools=tools,
)
app = App(
name="scheduling_app",
root_agent=agent,
plugins=[plugin],
)
async with InMemoryRunner(app=app) as runner:
events = await runner.run_debug(
"Get my most recent scheduled meeting from Calendly.",
quiet=True,
)
# Extract the agent's final text response
for event in reversed(events):
if event.content and event.content.parts:
text_parts = [p.text for p in event.content.parts if p.text]
if text_parts:
print("".join(text_parts))
break
asyncio.run(main())
import asyncio
from google.adk.agents import Agent
from google.adk.runners import InMemoryRunner
from stackone_adk import StackOnePlugin
async def main():
plugin = StackOnePlugin()
# Or scope to a specific account:
# plugin = StackOnePlugin(account_id="YOUR_ACCOUNT_ID")
tools = plugin.get_tools()
print(f"Discovered {len(tools)} tools")
agent = Agent(
model="gemini-2.5-flash",
name="scheduling_agent",
description="Manages scheduling, HR, and CRM through StackOne.",
instruction=(
"You are a helpful assistant powered by StackOne. "
"You help users manage their scheduling, HR, and CRM tasks "
"by using the available tools.\n\n"
"Always be helpful and provide clear, organized responses."
),
tools=tools,
)
async with InMemoryRunner(
app_name="scheduling_app", agent=agent
) as runner:
events = await runner.run_debug(
"Get my most recent scheduled meeting from Calendly.",
quiet=True,
)
# Extract the agent's final text response
for event in reversed(events):
if event.content and event.content.parts:
text_parts = [p.text for p in event.content.parts if p.text]
if text_parts:
print("".join(text_parts))
break
asyncio.run(main())
Available tools¶
Unlike integrations with a fixed set of tools, StackOne tools are dynamically discovered from your connected providers via the StackOne API. The available tools depend on which SaaS providers you have connected in your StackOne Dashboard.
To list discovered tools:
plugin = StackOnePlugin(account_id="YOUR_ACCOUNT_ID") # Optional: omit to use all connected accounts
for tool in plugin.get_tools():
print(f"{tool.name}: {tool.description}")
Supported integration categories¶
| Category | Example providers |
|---|---|
| HRIS | HiBob, BambooHR, Workday, SAP SuccessFactors, Personio, Gusto |
| ATS | Greenhouse, Ashby, Lever, Bullhorn, SmartRecruiters, Teamtailor |
| CRM & Sales | Salesforce, HubSpot, Pipedrive, Zoho CRM, Close, Copper |
| Marketing | Mailchimp, Klaviyo, ActiveCampaign, Brevo, GetResponse |
| Ticketing & Support | Zendesk, Freshdesk, Jira, ServiceNow, PagerDuty, Linear |
| Productivity | Asana, ClickUp, Slack, Microsoft Teams, Notion, Confluence |
| Scheduling | Calendly, Cal.com |
| LMS & Learning | 360Learning, Docebo, Go1, Cornerstone, LinkedIn Learning |
| Commerce | Shopify, BigCommerce, WooCommerce, Etsy |
| Developer Tools | GitHub, GitLab, Twilio |
For a complete list of 200+ supported providers, visit the StackOne integrations page.
Configuration¶
Plugin parameters¶
| Parameter | Type | Default | Description |
|---|---|---|---|
api_key |
str | None |
None |
StackOne API key. Falls back to STACKONE_API_KEY env var. |
account_id |
str | None |
None |
Default account ID for all tools. |
base_url |
str | None |
None |
API URL override (default: https://api.stackone.com). |
plugin_name |
str |
"stackone_plugin" |
Plugin identifier for ADK. |
providers |
list[str] | None |
None |
Filter by provider names (e.g., ["calendly", "hibob"]). |
actions |
list[str] | None |
None |
Filter by action patterns using glob syntax. |
account_ids |
list[str] | None |
None |
Scope tools to specific connected account IDs. |
Tool filtering¶
Filter tools by provider, action pattern, account ID, or any combination:
# Specify accounts
plugin = StackOnePlugin(account_ids=["acct-hibob-1", "acct-bamboohr-1"])
# Read-only operations
plugin = StackOnePlugin(actions=["*_list_*", "*_get_*"])
# Specific actions with glob patterns
plugin = StackOnePlugin(actions=["calendly_list_events", "calendly_get_event_*"])
# Combined filters
plugin = StackOnePlugin(
actions=["*_list_*", "*_get_*"],
account_ids=["acct-hibob-1"],
)