CellCog Connectors Guide
Connectors enable AI agents to interact with external services like Google Drive, Slack, Gmail, and more. This guide covers platform integrations, agent tools, and workflows.
What Are Connectors?
Connectors let AI agents:
- Access your files in Google Drive
- Send emails via Gmail
- Post to Slack
- Interact with many other services
Important: Connecting a service doesn't automatically give agents access. You must explicitly grant access in each chat.
Accessing Connectors
Open Connectors from the sidebar, or go directly to cellcog.ai/connectors. The page has three areas: Platforms (file imports), Delegations (bring CellCog into your tools), and Tools (agent actions + Keys).
Platform Integrations
Google Drive
Connect Google Drive to import files directly into CellCog.
Connecting:
- Go to Connectors tab
- Find Google Drive card
- Click Connect
- Authorize with Google
- Connection complete
Using Google Drive:
- Import files when uploading to Projects or Organization
- Select "Google Drive" in file upload dialogs
Disconnecting:
- Go to Connectors tab
- Click Disconnect on Google Drive card
Delegations
Delegations let you bring CellCog into the platforms your team already uses. Instead of coming to CellCog, CellCog comes to you — assign a task from within Linear, Cursor, Claude Code, or OpenClaw, and CellCog delivers results back where you were.
Available Delegation Platforms
Coming Soon
- Slack — @CellCog from any channel
- Microsoft Teams — Delegate from Teams chats
- Jira — Assign Jira issues to @CellCog
- Notion — Assign a Notion page to CellCog
Connecting a Delegation Platform
Each platform has its own connection flow:
Managing Delegations
Go to Connectors → Delegations to see all connected platforms, task counts, and connection status.
Agent Tools (Composio)
Agent tools let AI perform actions on external services during chats. The catalog covers 1,000+ apps with 20,000+ tools — Gmail, Slack, Linear, Jira, Notion, HubSpot, Salesforce, Shopify, Stripe, Figma, Canva, Google Analytics, and many more.
Connecting an Agent Tool
- Go to Connectors → Tools (or cellcog.ai/connectors/tools)
- Search or browse for the service
- Click Connect
- Complete OAuth authorization (or paste an API key for key-based services)
- Wait for processing
Each tool's connect page also shows what agents can do with it before you authorize.
Using Agent Tools in Chats
Important: Connecting a tool doesn't automatically give agents access.
To grant access in a chat:
- In the chat editor, click the Tools selector
- Choose which connected tools to enable
- Send your message
The agent can now use those tools for that chat.
Security Best Practices
⚠️ Read carefully before connecting tools:
- Only connect tools you need for your current tasks
- Manually select tools per chat — don't give blanket access
- Prompt agents to confirm before critical actions
- Review tool actions agents take
Recommended reading: Agentic Misalignment Research
Disconnecting Agent Tools
- Go to Connectors → Tools
- Find the connected service
- Click Disconnect
- Confirm disconnection
Refreshing Tools
If a service's capabilities change:
- Find the connected service
- Click Refresh Tools
- Updated actions become available
Keys (raw API credentials)
Some services aren't in the tools catalog, or an agent's scripts need a raw credential directly. The Keys page at Connectors → Tools → Keys (cellcog.ai/connectors/keys) is the home for these.
How Keys work
- Add a key with a service name, a key name (e.g.
MY_SERVICE_API_KEY — this is the environment variable name agents read in scripts), a value, and an optional description. - Values are stored encrypted and are write-only: after saving, a key can be rotated by re-adding the same name, but never read back.
- In any chat where Tools is enabled, your keys are injected into the agent's workspace environment — available immediately, including keys added mid-conversation. Removing a key revokes access just as fast.
- Keys are account-level: every agent working for you (regular chats and AI employees) sees the same keychain when Tools is on.
- Connecting an API-key-based tool from the catalog also saves that credential as a key automatically — one paste covers both the tool connection and script access.
- Disconnecting a tool removes its credentials from your account entirely.
Keys vs Tools
Tools are connections you authorize with a click — agents call their actions directly (send a Slack message, create a ticket). Keys are credentials you paste — agents' own scripts read them from the environment. If a service you search for isn't in the catalog, the search results offer "Connect it with an API key," which takes you to the Keys page.
Workflows
Workflows are reusable automation sequences you can build visually.
What Are Workflows?
Workflows combine multiple tools and actions into a single, reusable process. Examples:
- "Weekly Report Generator" — searches data, generates report, emails it
- "Social Media Publisher" — creates content, posts to multiple platforms
- "Customer Response" — analyzes inquiry, drafts response, creates ticket
Accessing Workflows
- Go to Profile
- Click Workflows tab
Creating a Workflow
- Click Create Workflow
- Use the visual editor to:
- Add nodes (tools, text, logic)
- Connect nodes to define flow
- Configure each node's settings
- Save your workflow
Workflow Editor
Node Types:
- Text Node: Static text or instructions
- Tool Node: Actions from connected services
Building a Workflow:
- Drag nodes from the palette
- Connect nodes by dragging between ports
- Configure each node's parameters
- Validate and save
Using Workflows in Chats
- In the chat editor, click the Workflows selector
- Choose a workflow to enable
- Reference the workflow in your prompt
The agent will follow the workflow's defined steps.
Public Workflow Library
Browse workflows shared by others:
- Go to Workflows tab
- Click Public Library
- View available workflows
- Copy interesting workflows to customize
Sharing Workflows
Share your workflows with others:
- Open your workflow
- Click Share
- Choose sharing options
- Others can copy and use it
Privacy & Security
OAuth 2.0
All connections use OAuth 2.0:
- Your passwords are never shared with CellCog
- You authorize specific permissions
- Revoke access anytime
Revoking Access
To revoke CellCog's access to a service:
- Disconnect in CellCog Connectors tab
- Additionally, revoke in the service's settings:
- Google: myaccount.google.com → Security → Third-party apps
- Slack: Slack settings → Manage apps
- Other services: Check their security settings
Data Handling
- CellCog accesses services only when you grant permission
- Actions are performed on your behalf
- Audit logs track agent actions
Frequently Asked Questions
Do I need to connect tools for every chat?
No. You connect tools once, then selectively enable them per chat using the Tools selector.
Can agents access my services without permission?
No. You must explicitly enable tools in each chat. Connecting a service just makes it available.
What if I disconnect a tool mid-chat?
The agent loses access immediately. Ongoing operations may fail.
Are my credentials stored by CellCog?
No. We use OAuth tokens, not passwords. Tokens can be revoked anytime.
Can I see what actions agents take?
Yes. Agent actions are visible in chat history and audit logs.
What happens if a tool connection expires?
You'll need to reconnect. Some services require periodic re-authorization.
Can I create workflows with tools I haven't connected?
You can design workflows with any tools, but they'll only work when the tools are connected.
Troubleshooting
Connection Failed
- Try disconnecting and reconnecting
- Check the service's status page
- Ensure you have proper permissions in the service
- Contact support if issues persist
Tool Not Appearing
- Refresh the Connectors page
- Check if the connection is complete
- Try refreshing tools for that service
Workflow Errors
- Check the validation panel for errors
- Ensure all required nodes are configured
- Verify tool connections are active
Related Guides