How to give your Charms access to Zapier, Google BigQuery, GitHub and thousands of other services — and what happens when you do.
|
|
How This Works
Every external service your Charm can use is accessed through an MCP server — a standardized endpoint that exposes the service's capabilities as discrete tools. Your Charm calls those tools. The service executes the action and returns the result. You never see any of this directly; it happens as part of a normal completion.Before a Charm can use an MCP server, two things need to be in place:
Your or your Company administrator has added the MCP server to the available integrations
You have authorized your account with that service
Once both are true, your Charm can use it.
Authorizing a Connection
When you try to use a Charm that has access to an OAuth-protected MCP server for the first time, CharmIQ prompts you to authorize. A browser window opens, you sign in to the external service (Google, GitHub, Slack, etc.), and you grant the requested permissions. That's it.CharmIQ stores your encrypted access token. From that point forward, your Charm uses it automatically — you don't need to authorize again unless you revoke access or the token expires (in which case CharmIQ refreshes it silently).You're authorizing your own account. Your colleague's authorization doesn't give your Charms access and yours doesn't give theirs. Connections are per-user and per-service.
What Happens at Runtime
When you run a Charm and it needs to call an external service:
CharmIQ retrieves your access token for that service
If the token is expired, it's refreshed automatically
The token is passed to the AI model along with the MCP server details
The model calls the appropriate tools during its reasoning process
Results come back into the workspace — your Charm sees the data and responds
This is transparent. You don't prompt differently. You don't manage tokens. You just work.
What You Can Connect To
The specific services available depend on what your organization administrator has configured. Common patterns:Zapier: A single Zapier connection exposes tools for thousands of services: Slack, Google Sheets, Salesforce, HubSpot, Monday.com, Trello, and on. If Zapier can do it, a Charm with Zapier access can do it.Google BigQuery: Your Charm can run SQL queries against your data warehouse. Ask it a business question; it figures out what to query, executes it, and interprets the results.GitHub: Browse repositories, read pull requests, search code, list issues. Useful for engineering managers who want to understand what shipped without opening GitHub, and for developers who want a Charm that understands the actual codebase.Google Documentation: Google exposes their technical documentation through MCP. A Charm with this connection can answer Google Cloud and API questions from the source, not from training data.
Managing Your Connections
You can view and revoke your connections through CharmIQ's authorization settings. If you have multiple accounts with the same service — a personal and work Google account, for example — you can have separate connections for each. CharmIQ uses whichever one you've marked as default, or prompts you to choose if no default is set.Revoking a connection removes CharmIQ's access to that service immediately. The Charm can still run; it just can't call that MCP server's tools until you reauthorize.
Patterns
Authorize once, use everywhere. The same connection works across all your Charms and workspaces.
Revoke when the work is done. If you connected a service for a specific project and no longer need it, revoke it. Clean house.
If a Charm doesn't have access, it will tell you. The completion will pause and prompt you to authorize rather than silently failing.
Scope matters. Your administrator may have restricted which tools an MCP server can expose. If a Charm can't do something you expect it to, check with your admin about the configured tool permissions.
Next Steps
→ What Are Integrations? — The overview: how inbound, outbound, and Application connections all fit together.→ Managing Integrations — Organization admins: how to set up the services your team can connect to.→ Multi-Charm Workflows — Putting connected Charms to work in sequence on a real problem.→ Research & Data — How to structure research workflows that use live data sources effectively.