# Podio

```json
{
  "name": "Podio",
  "slug": "podio",
  "url": "https://composio.dev/toolkits/podio",
  "markdown_url": "https://composio.dev/toolkits/podio.md",
  "logo_url": "https://logos.composio.dev/api/podio",
  "categories": [
    "productivity & project management"
  ],
  "is_composio_managed": false,
  "updated_at": "2026-11-14T06:01:21.706Z"
}
```

![Podio logo](https://logos.composio.dev/api/podio)

## Description

Securely connect your AI agents and chatbots (Claude, ChatGPT, Cursor, etc) with Podio MCP or direct API to create items, manage tasks, update workflows, and access files through natural language.

## Summary

Podio is a collaborative work platform for app-based workflows, tasks, items, files, and business data.
It gives teams flexible workspaces to organize processes and keep related information together.

## Categories

- productivity & project management

## Toolkit Details

- Tools: 143

## Images

- Logo: https://logos.composio.dev/api/podio

## Authentication

- **Oauth2**
  - Type: `oauth2`
  - Description: Oauth2 authentication for Podio.
  - Setup:
    - Configure Oauth2 credentials for Podio.
    - Use the credentials when creating an auth config in Composio.

## Suggested Prompts

- Create tasks from new Podio items
- Find overdue tasks across my Podio workspaces
- Update status on recently changed Podio items

## Supported Tools

| Tool slug | Name | Description |
|---|---|---|
| `PODIO_ACTIVATE_APP` | Activate App | Activate a deactivated Podio app, restoring it to the app navigator and allowing new item creation. |
| `PODIO_ADD_NEW_APP` | Add New App | Create a Podio app on a space with its configuration and fields. |
| `PODIO_ADD_NEW_APP_FIELD` | Add New App Field | Add a field to a Podio app. |
| `PODIO_ADD_NEW_ORGANIZATION` | Add New Organization | Create a new Podio organization. This administrative action creates a new organization visible to its members. |
| `PODIO_ARCHIVE_SPACE` | Archive Space | Archive a Podio space, hiding it from navigation without deleting its contents. |
| `PODIO_ASSIGN_TASK` | Assign Task | Assign a Podio task to a user, or remove its responsible user. |
| `PODIO_BULK_DELETE_ITEMS` | Bulk Delete Items | Permanently delete explicitly selected or filter-matched items from an app and remove them from all views. Deleted data cannot be retrieved. |
| `PODIO_CALCULATE_ITEMS` | Calculate Items | Calculate an aggregation over items in a Podio app, optionally grouped and filtered. |
| `PODIO_CLONE_ITEM` | Clone Item | Create a new item in the same app with values identical to the selected item. |
| `PODIO_COMPLETE_TASK` | Complete Task | Mark a Podio task complete. Completing a recurring task may create its next task and return that task's ID. |
| `PODIO_CREATE_COMMENT` | Create Comment | Add a comment to a Podio object, optionally attaching uploaded files or an embedded link. Setting alert_invite to true may also invite mentioned users who lack access to the workspace. |
| `PODIO_CREATE_ITEM` | Create Item | Create an item in a Podio app using field IDs or external IDs, with optional files, tags, reminder, recurrence, and reference. |
| `PODIO_CREATE_ORGANIZATION_APP_STORE_PROFILE` | Create Organization App Store Profile | Administratively create an app-store profile for a Podio organization when one does not already exist. |
| `PODIO_CREATE_REFERENCED_TASK` | Create Referenced Task | Create a Podio task attached through the reference-specific task route. |
| `PODIO_CREATE_SPACE` | Create Space | Create a new Podio space in an organization. |
| `PODIO_CREATE_TASK` | Create Task | Create a personal or referenced Podio task with assignment, due date, labels, files, reminder, and recurrence. |
| `PODIO_CREATE_TASK_LABEL` | Create Task Label | Create a personal Podio task label with a name and hex color. |
| `PODIO_DEACTIVATE_APP` | Deactivate App | Deactivate a Podio app, removing it from the app navigator and preventing new item creation. |
| `PODIO_DELETE_APP` | Delete App | Permanently delete a Podio app and all of its items, widgets, filters, and shares. This cannot be reversed. |
| `PODIO_DELETE_APP_FIELD` | Delete App Field | Remove a field from new and updated app items. Existing items retain the field unless delete_values is true. |
| `PODIO_DELETE_COMMENT` | Delete Comment | Delete one Podio comment by ID; use only for a comment the caller intends to remove. |
| `PODIO_DELETE_ITEM` | Delete Item | Delete one Podio item by ID; use only for an item the caller intends to remove. |
| `PODIO_DELETE_ITEM_REFERENCE` | Delete Item Reference | Remove the reference currently attached to a Podio item, if any. |
| `PODIO_DELETE_ORGANIZATION_APP_STORE_PROFILE` | Delete Organization App Store Profile | Permanently delete an organization's app-store profile. This destructive administrative action removes the profile rather than clearing individual fields. |
| `PODIO_DELETE_ORGANIZATION_MEMBER_ROLE` | Delete Organization Member Role | Remove a user's organization-level role. This destructive administrative action changes the user's authorization in the organization. |
| `PODIO_DELETE_SPACE` | Delete Space | Permanently delete a Podio space, ending all of its memberships and cancelling all outstanding space invitations. |
| `PODIO_DELETE_TASK` | Delete Task | Delete one Podio task by ID; use only for a task the caller intends to remove. |
| `PODIO_DELETE_TASK_LABEL` | Delete Task Label | Delete one personal Podio task label. |
| `PODIO_DELETE_USER_PROPERTY` | Delete User Property | Delete one auth-client-specific property from the active Podio user. |
| `PODIO_END_ORGANIZATION_MEMBERSHIP` | End Organization Membership | Permanently end a user's membership in every space in an organization. This destructive administrative action promotes other users where the target is the last admin and deletes workspaces where the target is the only member. |
| `PODIO_EXPORT_ITEMS` | Export Items | Create a Podio batch that exports app items in XLS or XLSX format. |
| `PODIO_FILTER_ITEMS_BY_VIEW` | Filter Items By View | Retrieve items from a Podio app using a saved view and optional paging or sorting overrides. Setting remember persists the view selection. |
| `PODIO_FIND_REFERENCEABLE_ITEMS` | Find Referenceable Items | Search the apps allowed by a Podio reference field for items matching text. |
| `PODIO_GET_ADMIN_ORGS_BY_EMAIL` | Get Admin Organizations by Email | Look up organizations administered by an email address and free organizations containing it. This administrative lookup exposes organization membership and domain information. |
| `PODIO_GET_ALL_APPS` | Get All Apps | Search apps available to the connected user. |
| `PODIO_GET_ALL_SPACES_ON_ORGANIZATION` | Get All Spaces on Organization | As an organization administrator, list every workspace in the organization. Names and URLs are omitted for workspaces the administrator has not joined. |
| `PODIO_GET_APP` | Get App | Return a Podio app's metadata and field definitions so an agent can construct valid item values. |
| `PODIO_GET_APP_BY_LABELS` | Get App by Organization, Space, and App Labels | Get a Podio app using its organization, space, and app URL labels. |
| `PODIO_GET_APP_DEPENDENCIES` | Get App Dependencies | Get the apps an app depends on and the dependency graph. |
| `PODIO_GET_APP_FIELD` | Get App Field | Get one Podio app field by numeric ID or external ID. |
| `PODIO_GET_APP_INVERSE_DEPENDENCIES` | Get App Inverse Dependencies | Get apps and fields that depend on a Podio app. |
| `PODIO_GET_APP_ON_SPACE_BY_URL_LABEL` | Get App on Space by URL Label | Get a Podio app in a space by its URL label. |
| `PODIO_GET_AVAILABLE_SEATS` | Get Available Seats | Return the available employee and external seats in a Podio space. |
| `PODIO_GET_AVAILABLE_SPACES` | Get Available Spaces | List open Podio spaces in an organization that the connected user can join. |
| `PODIO_GET_COMMENT` | Get Comment | Return one Podio comment by ID, including files, embeds, likes, and questions. |
| `PODIO_GET_COMMENT_REVISIONS` | Get Comment Revisions | Return all revisions of a Podio comment, including the current revision, ordered oldest first. |
| `PODIO_GET_CURRENT_USER` | Get Current User | Return the connected Podio user's identity, profile, locale, timezone, and account status. |
| `PODIO_GET_FEATURES` | Get App Features | Get features available from selected Podio apps. |
| `PODIO_GET_FIELD_RANGES` | Get Field Ranges | Return the minimum and maximum values for a number, calculation, or money field. |
| `PODIO_GET_ICON_SUGGESTIONS` | Get Icon Suggestions | Search Podio app icon suggestions. |
| `PODIO_GET_ITEM` | Get Item | Return one Podio item with its app, field values, revisions, comments, files, tags, references, and rights. By default, this also marks new item notifications as viewed; set mark_as_viewed to false to avoid that side effect. |
| `PODIO_GET_ITEM_BY_APP_ITEM_ID` | Get Item By App Item ID | Return a full Podio item using its app ID and app-local item ID. |
| `PODIO_GET_ITEM_BY_EXTERNAL_ID` | Get Item By External ID | Return a Podio app item using its external-system identifier. |
| `PODIO_GET_ITEM_CLONE` | Get Item Clone | Return unsaved clone-ready values for a Podio item; this does not create an item. |
| `PODIO_GET_ITEM_COUNT` | Get Item Count | Count items in a Podio app matching a saved view or documented scalar filters. |
| `PODIO_GET_ITEM_FIELD_VALUES` | Get Item Field Values | Return values for one numeric field ID on a Podio item. |
| `PODIO_GET_ITEM_FIELD_VALUES_V2` | Get Item Field Values V2 | Return values for a Podio item field selected by numeric ID or external ID. |
| `PODIO_GET_ITEM_PREVIEW_FOR_FIELD_REFERENCE` | Get Item Preview For Field Reference | Return an item preview formatted for use by a specific Podio reference field. |
| `PODIO_GET_ITEM_REFERENCES` | Get Item References | Return up to the requested limit of items that reference a Podio item, grouped by app and field. |
| `PODIO_GET_ITEM_REVISION` | Get Item Revision | Return metadata for a specific revision of a Podio item. |
| `PODIO_GET_ITEM_REVISION_DIFFERENCE` | Get Item Revision Difference | Return field-value differences between two revisions of a Podio item. |
| `PODIO_GET_ITEM_REVISIONS` | Get Item Revisions | Return up to the latest 30 revisions of a Podio item. |
| `PODIO_GET_ITEMS_AS_XLSX` | Get Items As XLSX | Download up to 1000 filtered Podio app items as an XLSX file. |
| `PODIO_GET_ITEM_VALUES` | Get Item Values | Return all populated fields and values for a Podio item. |
| `PODIO_GET_ITEM_VALUES_V2` | Get Item Values V2 | Return the field values on a Podio item using the v2 value representation. |
| `PODIO_GET_MEETING_URL` | Get Meeting URL | Get the join URL for a Podio meeting item. For the organizer, this request may start the meeting and return an automatic-login URL. |
| `PODIO_GET_NOTIFICATION_SETTING` | Get Notification Setting | Get whether one Podio notification type is enabled for an email or mobile client. |
| `PODIO_GET_NOTIFICATION_SETTINGS` | Get Notification Settings | Get all Podio notification-type settings for an email or mobile client. |
| `PODIO_GET_ORGANIZATION` | Get Organization | Get a Podio organization by ID, including its account limits, domains, role, tier, and creator metadata. |
| `PODIO_GET_ORGANIZATION_ADMINS` | Get Organization Admins | List the users who administer a Podio organization. |
| `PODIO_GET_ORGANIZATION_APP_STORE_PROFILE` | Get Organization App Store Profile | Get an organization's app-store profile, including its revision and Podio contact-area fields. |
| `PODIO_GET_ORGANIZATION_BY_URL` | Get Organization by URL | Resolve a Podio organization from its full URL or the URL of a resource within it. |
| `PODIO_GET_ORGANIZATION_LOGIN_REPORT` | Get Organization Login Report | Retrieve an administrative report of total and active organization users by week. The report exposes organization-wide login activity counts. |
| `PODIO_GET_ORGANIZATION_MEMBER` | Get Organization Member | Get a user's member data, contact profile, role, tier, and space counts in a Podio organization. |
| `PODIO_GET_ORGANIZATION_MEMBERS` | Get Organization Members | As an organization administrator, list invited and active members. Invited users may expose only limited user and profile information. |
| `PODIO_GET_ORGANIZATION_TASK_SUMMARY` | Get Organization Task Summary | Get task summary groups for one Podio organization. |
| `PODIO_GET_PERSONAL_TASK_SUMMARY` | Get Personal Task Summary | Get summary groups for personal tasks and personal-space tasks. |
| `PODIO_GET_PROFILE_FIELD` | Get Profile Field | Get one contact-area profile field for the active Podio user. |
| `PODIO_GET_RECALC_STATUS_FOR_FIELD` | Get Recalculation Status For Field | Return recalculation status for a calculation field on a Podio item. |
| `PODIO_GET_REFERENCES_TO_ITEM_BY_FIELD` | Get References To Item By Field | Return items that reference a Podio item through one specific app field. |
| `PODIO_GET_REFERENCE_TASK_COUNT` | Get Reference Task Count | Get the total number of open tasks on a referenced Podio object. |
| `PODIO_GET_REFERENCE_TASK_SUMMARY` | Get Reference Task Summary | Get task summary groups for one referenced Podio object. |
| `PODIO_GET_SHARED_ORGANIZATIONS` | Get Shared Organizations | List organizations and spaces that the connected user shares with another Podio user, sorted by name. |
| `PODIO_GET_SPACE` | Get Space | Return a Podio space by ID, including its settings, rights, creator, and membership state. |
| `PODIO_GET_SPACE_APP_DEPENDENCIES` | Get Space App Dependencies | Get apps on a Podio space and their dependency graph. |
| `PODIO_GET_SPACE_BY_ORG_AND_URL_LABEL` | Get Space by Organization and URL Label | Return a Podio space using its organization ID and URL label. |
| `PODIO_GET_SPACE_BY_URL` | Get Space by URL | Resolve a Podio space and its organization from a full URL or organization and space slugs. |
| `PODIO_GET_SPACE_MEMBERSHIPS_FOR_ORG_MEMBER` | Get Space Memberships for Organization Member | As an organization administrator, list a member's workspace memberships. Sensitive workspace names and URLs are hidden when the requesting administrator is not a workspace member. |
| `PODIO_GET_SPACE_TASK_SUMMARY` | Get Space Task Summary | Get task summary groups for one Podio space. |
| `PODIO_GET_TASK` | Get Task | Return one Podio task with assignment, due dates, reference, labels, files, recurrence, and comments. |
| `PODIO_GET_TASK_SUMMARY` | Get Task Summary | Get the connected user's overdue, today, and other task groups. |
| `PODIO_GET_TASK_TOTAL_BY_TIME` | Get Task Total By Time | Get the number of tasks in a documented Podio time bucket. |
| `PODIO_GET_TASK_TOTALS` | Get Task Totals | Get active-task totals for owned and reassigned Podio tasks. |
| `PODIO_GET_TOP_APPS` | Get Top Apps | Get the connected user's top Podio apps. |
| `PODIO_GET_TOP_APPS_FOR_ORGANIZATION` | Get Top Apps for Organization | Get top Podio apps in an organization. |
| `PODIO_GET_TOP_SPACES` | Get Top Spaces | Return the top Podio spaces for the connected user. |
| `PODIO_GET_TOP_VALUES_FOR_FIELD` | Get Top Values For Field | Return the top possible item values for a Podio field of type app. |
| `PODIO_GET_USER` | Get User | Get the active Podio user's account details. |
| `PODIO_GET_USER_PROPERTY` | Get User Property | Get an auth-client-specific JSON object property for the active Podio user. |
| `PODIO_INCOMPLETE_TASK` | Reopen Task | Mark a completed Podio task incomplete using Podio's task route. |
| `PODIO_INSTALL_APP` | Install App | Install a Podio app on a space with selected features. |
| `PODIO_LIST_APPS` | List Apps | List active Podio apps in a space, optionally including inactive apps. |
| `PODIO_LIST_COMMENTS` | List Comments | Page through comments on a Podio object such as an item or task. |
| `PODIO_LIST_ITEMS` | List Items | Filter and page through items in one Podio app, returning item IDs, titles, fields, and match totals. Setting remember to true also persists the filter view in Podio. |
| `PODIO_LIST_ORGANIZATIONS` | List Organizations | List organizations available to the connected user, including member spaces and access rights. |
| `PODIO_LIST_ORGANIZATION_WORKSPACES` | List Organization Workspaces | List Podio spaces in an organization that are accessible to the connected user. |
| `PODIO_LIST_SPACES` | List Spaces | List the spaces the connected user can access in a Podio organization. |
| `PODIO_LIST_TASK_LABELS` | List Task Labels | List the connected user's personal Podio task labels. |
| `PODIO_LIST_TASKS` | List Tasks | Filter and page through Podio tasks visible to the connected user, including open or completed tasks and reference filters. |
| `PODIO_RANK_TASK` | Rank Task | Place a Podio task before or after other tasks in the task ranking. |
| `PODIO_REARRANGE_ITEM` | Rearrange Item | Apply documented from/to field-value changes and optional priority placement to a Podio item. |
| `PODIO_REMOVE_TASK_REFERENCE` | Remove Task Reference | Remove the object reference from a Podio task. |
| `PODIO_REPLACE_TASK_LABELS` | Replace Task Labels | Replace all labels on a Podio task using label IDs or label names. |
| `PODIO_RESTORE_SPACE` | Restore Space | Restore an archived Podio space, making it visible in navigation again. |
| `PODIO_REVERT_ITEM_REVISION` | Revert Item Revision | Destructively undo the change made in one revision. This restores the prior values and overwrites any later changes made to the same fields. |
| `PODIO_REVERT_TO_REVISION` | Revert To Revision | Destructively restore an item to all values in the selected revision, undoing every change made after that revision. |
| `PODIO_SET_PARTICIPATION` | Set Participation | Set the connected user's participation status on a Podio item. |
| `PODIO_SET_USER_PROPERTIES` | Set User Properties | Set one or more auth-client-specific JSON object properties for the active Podio user. |
| `PODIO_SET_USER_PROPERTY` | Set User Property | Set one auth-client-specific JSON object property for the active Podio user. |
| `PODIO_UPDATE_AN_APP_FIELD` | Update an App Field | Update the configuration of one Podio app field. |
| `PODIO_UPDATE_APP_DESCRIPTION` | Update App Description | Update a Podio app's description. |
| `PODIO_UPDATE_APP_EXPANDED` | Update App Configuration and Fields | Update a Podio app's configuration, fields, and field deletions. |
| `PODIO_UPDATE_APP_ORDER` | Update App Order | Set the order of apps in a Podio space. |
| `PODIO_UPDATE_APP_USAGE_INSTRUCTIONS` | Update App Usage Instructions | Update a Podio app's usage instructions. |
| `PODIO_UPDATE_APP_V2` | Update App and Return App | Update a Podio app's configuration and fields and return the app object. |
| `PODIO_UPDATE_COMMENT` | Update Comment | Replace a Podio comment's text, external ID, files, or embedded link. Omitting embed_id removes an existing embed, so resend its ID to preserve it. |
| `PODIO_UPDATE_ITEM` | Update Item | Update one Podio item's fields or metadata, optionally using its revision for optimistic concurrency. |
| `PODIO_UPDATE_ITEM_FIELD_VALUES` | Update Item Field Values | Replace the values of one Podio item field selected by numeric ID or external ID. |
| `PODIO_UPDATE_ITEM_VALUES` | Update Item Values | Replace values for multiple fields on a Podio item using field IDs or external IDs. |
| `PODIO_UPDATE_NOTIFICATION_SETTING` | Update Notification Setting | Enable or disable one Podio notification type for an email or mobile client. |
| `PODIO_UPDATE_NOTIFICATION_SETTINGS` | Update Notification Settings | Update multiple Podio notification-type settings for an email or mobile client. |
| `PODIO_UPDATE_ORGANIZATION` | Update Organization | Administratively update a Podio organization's name, URL subdomain, or logo. Changing the name alone does not change its URL. |
| `PODIO_UPDATE_ORGANIZATION_APP_STORE_PROFILE` | Update Organization App Store Profile | Administratively replace fields on an existing Podio organization app-store profile. |
| `PODIO_UPDATE_PROFILE` | Update Profile | Update selected contact-area fields on the active Podio user's profile; omitted fields remain unchanged. |
| `PODIO_UPDATE_PROFILE_FIELD` | Update Profile Field | Update one contact-area field on the active Podio user's profile. |
| `PODIO_UPDATE_SPACE` | Update Space | Update a Podio space's name, privacy, automatic joining, URL label, or announcement settings. |
| `PODIO_UPDATE_TASK` | Update Task | Update a Podio task's full attributes, including completing or reopening it. COMPLETE_TASK and INCOMPLETE_TASK remain convenient dedicated state actions. |
| `PODIO_UPDATE_TASK_DESCRIPTION` | Update Task Description | Replace only the description of a Podio task. |
| `PODIO_UPDATE_TASK_DUE` | Update Task Due Date | Update only the UTC or local due fields of a Podio task. |
| `PODIO_UPDATE_TASK_LABEL` | Update Task Label | Replace the name and color of a personal Podio task label. |
| `PODIO_UPDATE_TASK_PRIVATE` | Update Task Privacy | Update only whether a Podio task is private. |
| `PODIO_UPDATE_TASK_REFERENCE` | Update Task Reference | Replace the object reference on a Podio task. |
| `PODIO_UPDATE_TASK_TEXT` | Update Task Text | Replace only the text of a Podio task. |

## Supported Triggers

None listed.

## Installation and MCP Setup

### Path 1: SDK Installation

#### Path 1, Step 1: Install Composio

Install the Composio SDK, the OpenAI provider, and the OpenAI SDK
```python
pip install composio composio_openai openai
```

```typescript
npm install @composio/core @composio/openai openai
```

#### Path 1, Step 2: Create a Composio session

Initialize Composio with the OpenAI Responses provider and create a session scoped to Podio
```python
import json
from openai import OpenAI
from composio import Composio
from composio_openai import OpenAIResponsesProvider

composio = Composio(provider=OpenAIResponsesProvider())
client = OpenAI()

session = composio.create(user_id="your-user-id", toolkits=["podio"])
tools = session.tools()
```

```typescript
import OpenAI from "openai";
import { Composio } from "@composio/core";
import { OpenAIResponsesProvider } from "@composio/openai";

const composio = new Composio({ provider: new OpenAIResponsesProvider() });
const client = new OpenAI();

const session = await composio.create("your-user-id", { toolkits: ["podio"] });
const tools = await session.tools();
```

#### Path 1, Step 3: Run Podio tools with your agent

Send a request, execute the Podio tool calls through the session, and print the final answer
```python
response = client.responses.create(
    model="gpt-5.6-sol",
    tools=tools,
    input=[{"role": "user", "content": "Create a new Podio task titled 'Prepare Q4 client report' due Friday in my Marketing workspace."}],
)

while True:
    tool_calls = [o for o in response.output if o.type == "function_call"]
    if not tool_calls:
        break
    results = composio.provider.handle_tool_calls(response=response, session=session)
    response = client.responses.create(
        model="gpt-5.6-sol",
        tools=tools,
        previous_response_id=response.id,
        input=[
            {"type": "function_call_output", "call_id": call.call_id, "output": json.dumps(results[i])}
            for i, call in enumerate(tool_calls)
        ],
    )

print(response.output_text)
```

```typescript
let response = await client.responses.create({
  model: "gpt-5.6-sol",
  tools,
  input: [{ role: "user", content: "Create a new Podio task titled 'Prepare Q4 client report' due Friday in my Marketing workspace." }],
});

while (response.output.some((o) => o.type === "function_call")) {
  const outputs = await composio.provider.handleToolCalls(session, response.output);
  response = await client.responses.create({
    model: "gpt-5.6-sol",
    tools,
    previous_response_id: response.id,
    input: outputs,
  });
}

console.log(response.output_text);
```

### Path 2: MCP Server Setup

#### Path 2, Step 1: Install Composio

Install the Composio SDK and your agent framework
```python
pip install composio claude-agent-sdk
```

```typescript
npm install @composio/core ai @ai-sdk/mcp @ai-sdk/openai
```

#### Path 2, Step 2: Create a session with MCP enabled

Create a session scoped to Podio and read its MCP URL and headers
```python
from composio import Composio

composio = Composio()
session = composio.create(user_id="your-user-id", toolkits=["podio"], mcp=True)
```

```typescript
import { Composio } from "@composio/core";

const composio = new Composio();
const { mcp } = await composio.create("your-user-id", {
  toolkits: ["podio"],
  mcp: true,
});
```

#### Path 2, Step 3: Connect your agent to the MCP server

Pass the session's MCP URL and headers to your agent and run a Podio request
```python
import asyncio
from claude_agent_sdk import ClaudeSDKClient, ClaudeAgentOptions, AssistantMessage, TextBlock

options = ClaudeAgentOptions(
    mcp_servers={
        "composio": {
            "type": "http",
            "url": session.mcp.url,
            "headers": session.mcp.headers,
        }
    },
    system_prompt="You are a helpful assistant with access to Podio tools.",
    tools=[],
    allowed_tools=["mcp__composio__*"],
)

async def main():
    async with ClaudeSDKClient(options=options) as client:
        await client.query("Create a new Podio task titled 'Prepare Q4 client report' due Friday in my Marketing workspace.")
        async for message in client.receive_response():
            if isinstance(message, AssistantMessage):
                for block in message.content:
                    if isinstance(block, TextBlock):
                        print(block.text)

asyncio.run(main())
```

```typescript
import { createMCPClient } from "@ai-sdk/mcp";
import { openai } from "@ai-sdk/openai";
import { generateText, stepCountIs } from "ai";

const client = await createMCPClient({
  transport: { type: "http", url: mcp.url, headers: mcp.headers },
});

const { text } = await generateText({
  model: openai("gpt-5.6-sol"),
  tools: await client.tools(),
  prompt: "Create a new Podio task titled 'Prepare Q4 client report' due Friday in my Marketing workspace.",
  stopWhen: stepCountIs(10),
});

console.log(text);
await client.close();
```

## Why Use Composio?

### 1. AI Native Podio Integration

- Supports both Podio MCP and direct API based integrations
- Structured, LLM-friendly schemas for reliable tool execution
- Rich coverage for reading, writing, and querying your Podio data

### 2. Managed Auth

- Built-in OAuth handling with automatic token refresh and rotation
- Central place to manage, scope, and revoke Podio access
- Per user and per environment credentials instead of hard-coded keys

### 3. Agent Optimized Design

- Tools are tuned using real error and success rates to improve reliability over time
- Comprehensive execution logs so you always know what ran, when, and on whose behalf

### 4. Enterprise Grade Security

- Fine-grained RBAC so you control which agents and users can access Podio
- Scoped, least privilege access to Podio resources
- Full audit trail of agent actions to support review and compliance

## Use Podio with any AI Agent Framework

Choose a framework you want to connect Podio with:

- [ChatGPT](https://composio.dev/toolkits/podio/framework/chatgpt)
- [Claude Cowork](https://composio.dev/toolkits/podio/framework/claude-cowork)
- [Grok Bot](https://composio.dev/toolkits/podio/framework/grok-bot)
- [Hermes](https://composio.dev/toolkits/podio/framework/hermes-agent)
- [Atomic Agent](https://composio.dev/toolkits/podio/framework/atomic-agent)

## Related Toolkits

- [Google Sheets](https://composio.dev/toolkits/googlesheets) - Google Sheets is a cloud-based spreadsheet tool for real-time collaboration and data analysis. It lets teams work together from anywhere, updating information instantly.
- [Notion](https://composio.dev/toolkits/notion) - Notion is a collaborative workspace for notes, docs, wikis, and tasks. It streamlines team knowledge, project tracking, and workflow customization in one place.
- [Airtable](https://composio.dev/toolkits/airtable) - Airtable combines the flexibility of spreadsheets with the power of a database for easy project and data management. Teams use Airtable to organize, track, and collaborate with custom views and automations.
- [Asana](https://composio.dev/toolkits/asana) - Asana is a collaborative work management platform for teams to organize and track projects. It streamlines teamwork, boosts productivity, and keeps everyone aligned on goals.
- [Google Tasks](https://composio.dev/toolkits/googletasks) - Google Tasks is a to-do list and task management tool integrated into Gmail and Google Calendar. It helps you organize, track, and complete tasks across your Google ecosystem.
- [Linear](https://composio.dev/toolkits/linear) - Linear is a modern issue tracking and project planning tool for fast-moving teams. It helps streamline workflows, organize projects, and boost productivity.
- [Jira](https://composio.dev/toolkits/jira) - Jira is Atlassian’s platform for bug tracking, issue tracking, and agile project management. It helps teams organize work, prioritize tasks, and deliver projects efficiently.
- [Clickup](https://composio.dev/toolkits/clickup) - ClickUp is an all-in-one productivity platform for managing tasks, docs, goals, and team collaboration. It streamlines project workflows so teams can work smarter and stay organized in one place.
- [Monday](https://composio.dev/toolkits/monday) - Monday.com is a customizable work management platform for project planning and collaboration. It helps teams organize tasks, automate workflows, and track progress in real time.
- [Addressfinder](https://composio.dev/toolkits/addressfinder) - Addressfinder is a data quality platform for verifying addresses, emails, and phone numbers. It helps you ensure accurate customer and contact data every time.
- [Agiled](https://composio.dev/toolkits/agiled) - Agiled is an all-in-one business management platform for CRM, projects, and finance. It helps you streamline workflows, consolidate client data, and manage business processes in one place.
- [Aha!](https://composio.dev/toolkits/aha) - Aha! is a product management platform for setting strategy, prioritizing ideas, and planning roadmaps. It helps product teams align goals with development work and make better decisions.
- [AirOps MCP](https://composio.dev/toolkits/airops_mcp) - AirOps MCP is AirOps' managed content platform exposing brand context, knowledge bases, and workflows. Use it to give agents brand-aware content, automate content workflows, and track Brand Kit edits.
- [Amazing Marvin](https://composio.dev/toolkits/amazing_marvin) - Amazing Marvin is a personal productivity app for tasks, projects, habits, planning, time tracking, and rewards. It helps you build a flexible workflow that matches how you actually work.
- [Ambiguous MCP](https://composio.dev/toolkits/ambiguous_mcp) - Ambiguous MCP is a provider-hosted workspace service for documents, spreadsheets, tasks, CRM, calendar, mail, chat, and administration. It provides one workspace-scoped connection for managing these resources through natural language.
- [AnyDB](https://composio.dev/toolkits/any_db) - AnyDB is a flexible collaborative database platform for organizing records, files, and automated workflows. It helps teams centralize data, collaborate on records, and automate routine tasks.
- [ApptiveGrid](https://composio.dev/toolkits/apptivegrid) - ApptiveGrid is a collaborative no-code database and app platform for spaces, grids, forms, and structured records. It helps teams organize operational data, collect inputs, and build lightweight business apps without custom backend work.
- [Ascora](https://composio.dev/toolkits/ascora) - Ascora is a cloud-based field service management platform for service businesses. It streamlines scheduling, invoicing, and customer operations in one place.
- [Atlassian MCP](https://composio.dev/toolkits/atlassian_mcp) - Atlassian Rovo MCP connects agents to Jira, Jira Service Management, Confluence, Bitbucket, Compass, and Teamwork Graph workflows. It lets teams surface and act on Atlassian data while respecting existing user permissions.
- [Basecamp](https://composio.dev/toolkits/basecamp) - Basecamp is a project management and team collaboration tool by 37signals. It helps teams organize tasks, share files, and communicate efficiently in one place.

## Frequently Asked Questions

### Do I need my own developer credentials to use Podio with Composio?

Yes, Podio requires you to configure your own OAuth credentials. Once set up, Composio handles token storage, refresh, and lifecycle management for you.

### Can I use multiple toolkits together?

Yes! Composio's Tool Router enables agents to use multiple toolkits. [Learn more](https://docs.composio.dev/tool-router/overview).

### Is Composio secure?

Composio is SOC 2 and ISO 27001 compliant with all data encrypted in transit and at rest. [Learn more](https://trust.composio.dev).

### What if the API changes?

Composio maintains and updates all toolkit integrations automatically, so your agents always work with the latest API versions.

---
[See all toolkits](https://composio.dev/toolkits) · [Composio docs](https://docs.composio.dev/llms.txt)
