# Integrations

> Use when user asks to interact with external apps like Gmail, GitHub, Slack, Google Calendar, Notion via Composio or MCP integrations. Direct API is faster than browser automation.

- **Type:** Skill
- **Install:** `agentstack add skill-vibesurf-ai-claude-surf-integrations`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [vibesurf-ai](https://agentstack.voostack.com/s/vibesurf-ai)
- **Installs:** 0
- **Category:** [Developer Tools](https://agentstack.voostack.com/c/developer-tools)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [vibesurf-ai](https://github.com/vibesurf-ai)
- **Source:** https://github.com/vibesurf-ai/claude-surf/tree/main/skills/integrations

## Install

```sh
agentstack add skill-vibesurf-ai-claude-surf-integrations
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Integrations - External App Automation

## Overview

Direct API access to 100+ external apps via Composio and MCP integrations.

## When to Use

- User needs Gmail, GitHub, Slack, etc.
- Service has Composio/MCP support
- Want faster, more reliable than browser automation

**Why use over browser?**
- Direct API = 10-100x faster
- More reliable (no UI changes)
- Better for bulk operations

## Available Actions

| Action | Purpose |
|--------|---------|
| `get_all_toolkit_types` | See all available apps |
| `search_extra_tool` | Find specific app actions |
| `get_extra_tool_info` | See action parameters |
| `execute_extra_tool` | Run app action |

## The Pattern

1. **List** available apps
2. **Search** for specific actions
3. **Get** parameter schema
4. **Execute** with parameters

## Tool Naming Convention

```
cpo.{service}.{action}     # Composio tools
mcp.{server}.{action}      # MCP tools
```

## Configuration Required

Before using Composio or MCP tools, you must configure them first:

| Integration | Configuration Skill | What to Configure |
|-------------|---------------------|-------------------|
| Composio (Gmail, GitHub, etc.) | `config-composio` | API key + enable toolkits |
| MCP servers | `config-mcp` | Add MCP server profiles |

**Workflow:**
1. Configure using appropriate `config-*` skill
2. Then use `integrations` skill to execute tools

For example:
1. First: `config-composio` → verify API key + enable `gmail` toolkit
2. Then: `integrations` → execute `cpo.gmail.GMAIL_SEND_EMAIL`

## Common Integrations

| Service | Common Actions |
|---------|----------------|
| Gmail | Send, read, organize emails |
| GitHub | Create PRs, issues, releases |
| Slack | Send messages, manage channels |
| Google Calendar | Create events, manage scheduling |
| Notion | Create pages, update databases |

## Best Practices

| Practice | Why |
|----------|-----|
| Search before execute | Find exact tool name and parameters |
| Use search filters | Reduce noise in results |
| Check authentication | Configure credentials in VibeSurf |
| Prefer integrations for API tasks | Faster than browser automation |

## Error Handling

| Error | Solution |
|-------|----------|
| Tool not found | Use `search_extra_tool` to find correct name |
| Auth failed | Configure credentials in VibeSurf |
| Invalid params | Use `get_extra_tool_info` to see schema |

## Integration vs Browser Automation

| Task | Use Integration | Use Browser |
|------|----------------|-------------|
| Send Gmail | ✅ Direct API | ❌ Slow |
| GitHub PR | ✅ Direct API | ❌ Overkill |
| Custom form | ❌ Not supported | ✅ `browser-use` |

**Rule:** If Composio/MCP supports the app, use integration.

## Common Toolkit Types

- `gmail`, `github`, `slack`
- `google_calendar`, `google_sheets`
- `notion`, `trello`, `asana`, `jira`
- Many more available via `get_all_toolkit_types`

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [vibesurf-ai](https://github.com/vibesurf-ai)
- **Source:** [vibesurf-ai/claude-surf](https://github.com/vibesurf-ai/claude-surf)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-vibesurf-ai-claude-surf-integrations
- Seller: https://agentstack.voostack.com/s/vibesurf-ai
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.