Podio MCP server for AI agents and assistants

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.

Podio logoPodio
Oauth2

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.

143 Tools

Try Podio now

Type what you want done — sign in and watch it run live in the Tool Router playground.

TOOL ROUTER PLAYGROUND
Podio
Try asking
TOOLS

Supported Tools

Every Podio action and event your agent gets out of the box.

Activate App

Activate a deactivated Podio app, restoring it to the app navigator and allowing new item creation.

Add New App

Create a Podio app on a space with its configuration and fields.

Add New App Field

Add a field to a Podio app.

Add New Organization

Create a new Podio organization.

Archive Space

Archive a Podio space, hiding it from navigation without deleting its contents.

Assign Task

Assign a Podio task to a user, or remove its responsible user.

Bulk Delete Items

Permanently delete explicitly selected or filter-matched items from an app and remove them from all views.

Calculate Items

Calculate an aggregation over items in a Podio app, optionally grouped and filtered.

Clone Item

Create a new item in the same app with values identical to the selected item.

Complete Task

Mark a Podio task complete.

Create Comment

Add a comment to a Podio object, optionally attaching uploaded files or an embedded link.

Create Item

Create an item in a Podio app using field IDs or external IDs, with optional files, tags, reminder, recurrence, and reference.

Create Organization App Store Profile

Administratively create an app-store profile for a Podio organization when one does not already exist.

Create Referenced Task

Create a Podio task attached through the reference-specific task route.

Create Space

Create a new Podio space in an organization.

Create Task

Create a personal or referenced Podio task with assignment, due date, labels, files, reminder, and recurrence.

Create Task Label

Create a personal Podio task label with a name and hex color.

Deactivate App

Deactivate a Podio app, removing it from the app navigator and preventing new item creation.

Delete App

Permanently delete a Podio app and all of its items, widgets, filters, and shares.

Delete App Field

Remove a field from new and updated app items.

Delete Comment

Delete one Podio comment by ID; use only for a comment the caller intends to remove.

Delete Item

Delete one Podio item by ID; use only for an item the caller intends to remove.

Delete Item Reference

Remove the reference currently attached to a Podio item, if any.

Delete Organization App Store Profile

Permanently delete an organization's app-store profile.

Delete Organization Member Role

Remove a user's organization-level role.

Delete Space

Permanently delete a Podio space, ending all of its memberships and cancelling all outstanding space invitations.

Delete Task

Delete one Podio task by ID; use only for a task the caller intends to remove.

Delete Task Label

Delete one personal Podio task label.

Delete User Property

Delete one auth-client-specific property from the active Podio user.

End Organization Membership

Permanently end a user's membership in every space in an organization.

Export Items

Create a Podio batch that exports app items in XLS or XLSX format.

Filter Items By View

Retrieve items from a Podio app using a saved view and optional paging or sorting overrides.

Find Referenceable Items

Search the apps allowed by a Podio reference field for items matching text.

Get Admin Organizations by Email

Look up organizations administered by an email address and free organizations containing it.

Get All Apps

Search apps available to the connected user.

Get All Spaces on Organization

As an organization administrator, list every workspace in the organization.

Get App

Return a Podio app's metadata and field definitions so an agent can construct valid item values.

Get App by Organization, Space, and App Labels

Get a Podio app using its organization, space, and app URL labels.

Get App Dependencies

Get the apps an app depends on and the dependency graph.

Get App Field

Get one Podio app field by numeric ID or external ID.

Get App Inverse Dependencies

Get apps and fields that depend on a Podio app.

Get App on Space by URL Label

Get a Podio app in a space by its URL label.

Get Available Seats

Return the available employee and external seats in a Podio space.

Get Available Spaces

List open Podio spaces in an organization that the connected user can join.

Get Comment

Return one Podio comment by ID, including files, embeds, likes, and questions.

Get Comment Revisions

Return all revisions of a Podio comment, including the current revision, ordered oldest first.

Get Current User

Return the connected Podio user's identity, profile, locale, timezone, and account status.

Get App Features

Get features available from selected Podio apps.

Get Field Ranges

Return the minimum and maximum values for a number, calculation, or money field.

Get Icon Suggestions

Search Podio app icon suggestions.

Get Item

Return one Podio item with its app, field values, revisions, comments, files, tags, references, and rights.

Get Item By App Item ID

Return a full Podio item using its app ID and app-local item ID.

Get Item By External ID

Return a Podio app item using its external-system identifier.

Get Item Clone

Return unsaved clone-ready values for a Podio item; this does not create an item.

Get Item Count

Count items in a Podio app matching a saved view or documented scalar filters.

Get Item Field Values

Return values for one numeric field ID on a Podio item.

Get Item Field Values V2

Return values for a Podio item field selected by numeric ID or external ID.

Get Item Preview For Field Reference

Return an item preview formatted for use by a specific Podio reference field.

Get Item References

Return up to the requested limit of items that reference a Podio item, grouped by app and field.

Get Item Revision

Return metadata for a specific revision of a Podio item.

Get Item Revision Difference

Return field-value differences between two revisions of a Podio item.

Get Item Revisions

Return up to the latest 30 revisions of a Podio item.

Get Items As XLSX

Download up to 1000 filtered Podio app items as an XLSX file.

Get Item Values

Return all populated fields and values for a Podio item.

Get Item Values V2

Return the field values on a Podio item using the v2 value representation.

Get Meeting URL

Get the join URL for a Podio meeting item.

Get Notification Setting

Get whether one Podio notification type is enabled for an email or mobile client.

Get Notification Settings

Get all Podio notification-type settings for an email or mobile client.

Get Organization

Get a Podio organization by ID, including its account limits, domains, role, tier, and creator metadata.

Get Organization Admins

List the users who administer a Podio organization.

Get Organization App Store Profile

Get an organization's app-store profile, including its revision and Podio contact-area fields.

Get Organization by URL

Resolve a Podio organization from its full URL or the URL of a resource within it.

Get Organization Login Report

Retrieve an administrative report of total and active organization users by week.

Get Organization Member

Get a user's member data, contact profile, role, tier, and space counts in a Podio organization.

Get Organization Members

As an organization administrator, list invited and active members.

Get Organization Task Summary

Get task summary groups for one Podio organization.

Get Personal Task Summary

Get summary groups for personal tasks and personal-space tasks.

Get Profile Field

Get one contact-area profile field for the active Podio user.

Get Recalculation Status For Field

Return recalculation status for a calculation field on a Podio item.

Get References To Item By Field

Return items that reference a Podio item through one specific app field.

Get Reference Task Count

Get the total number of open tasks on a referenced Podio object.

Get Reference Task Summary

Get task summary groups for one referenced Podio object.

Get Shared Organizations

List organizations and spaces that the connected user shares with another Podio user, sorted by name.

Get Space

Return a Podio space by ID, including its settings, rights, creator, and membership state.

Get Space App Dependencies

Get apps on a Podio space and their dependency graph.

Get Space by Organization and URL Label

Return a Podio space using its organization ID and URL label.

Get Space by URL

Resolve a Podio space and its organization from a full URL or organization and space slugs.

Get Space Memberships for Organization Member

As an organization administrator, list a member's workspace memberships.

Get Space Task Summary

Get task summary groups for one Podio space.

Get Task

Return one Podio task with assignment, due dates, reference, labels, files, recurrence, and comments.

Get Task Summary

Get the connected user's overdue, today, and other task groups.

Get Task Total By Time

Get the number of tasks in a documented Podio time bucket.

Get Task Totals

Get active-task totals for owned and reassigned Podio tasks.

Get Top Apps

Get the connected user's top Podio apps.

Get Top Apps for Organization

Get top Podio apps in an organization.

Get Top Spaces

Return the top Podio spaces for the connected user.

Get Top Values For Field

Return the top possible item values for a Podio field of type app.

Get User

Get the active Podio user's account details.

Get User Property

Get an auth-client-specific JSON object property for the active Podio user.

Reopen Task

Mark a completed Podio task incomplete using Podio's task route.

Install App

Install a Podio app on a space with selected features.

List Apps

List active Podio apps in a space, optionally including inactive apps.

List Comments

Page through comments on a Podio object such as an item or task.

List Items

Filter and page through items in one Podio app, returning item IDs, titles, fields, and match totals.

List Organizations

List organizations available to the connected user, including member spaces and access rights.

List Organization Workspaces

List Podio spaces in an organization that are accessible to the connected user.

List Spaces

List the spaces the connected user can access in a Podio organization.

List Task Labels

List the connected user's personal Podio task labels.

List Tasks

Filter and page through Podio tasks visible to the connected user, including open or completed tasks and reference filters.

Rank Task

Place a Podio task before or after other tasks in the task ranking.

Rearrange Item

Apply documented from/to field-value changes and optional priority placement to a Podio item.

Remove Task Reference

Remove the object reference from a Podio task.

Replace Task Labels

Replace all labels on a Podio task using label IDs or label names.

Restore Space

Restore an archived Podio space, making it visible in navigation again.

Revert Item Revision

Destructively undo the change made in one revision.

Revert To Revision

Destructively restore an item to all values in the selected revision, undoing every change made after that revision.

Set Participation

Set the connected user's participation status on a Podio item.

Set User Properties

Set one or more auth-client-specific JSON object properties for the active Podio user.

Set User Property

Set one auth-client-specific JSON object property for the active Podio user.

Update an App Field

Update the configuration of one Podio app field.

Update App Description

Update a Podio app's description.

Update App Configuration and Fields

Update a Podio app's configuration, fields, and field deletions.

Update App Order

Set the order of apps in a Podio space.

Update App Usage Instructions

Update a Podio app's usage instructions.

Update App and Return App

Update a Podio app's configuration and fields and return the app object.

Update Comment

Replace a Podio comment's text, external ID, files, or embedded link.

Update Item

Update one Podio item's fields or metadata, optionally using its revision for optimistic concurrency.

Update Item Field Values

Replace the values of one Podio item field selected by numeric ID or external ID.

Update Item Values

Replace values for multiple fields on a Podio item using field IDs or external IDs.

Update Notification Setting

Enable or disable one Podio notification type for an email or mobile client.

Update Notification Settings

Update multiple Podio notification-type settings for an email or mobile client.

Update Organization

Administratively update a Podio organization's name, URL subdomain, or logo.

Update Organization App Store Profile

Administratively replace fields on an existing Podio organization app-store profile.

Update Profile

Update selected contact-area fields on the active Podio user's profile; omitted fields remain unchanged.

Update Profile Field

Update one contact-area field on the active Podio user's profile.

Update Space

Update a Podio space's name, privacy, automatic joining, URL label, or announcement settings.

Update Task

Update a Podio task's full attributes, including completing or reopening it.

Update Task Description

Replace only the description of a Podio task.

Update Task Due Date

Update only the UTC or local due fields of a Podio task.

Update Task Label

Replace the name and color of a personal Podio task label.

Update Task Privacy

Update only whether a Podio task is private.

Update Task Reference

Replace the object reference on a Podio task.

Update Task Text

Replace only the text of a Podio task.

SETUP GUIDE

Connect Podio MCP Tool with your Agent

1

Install Composio

typescript
npm install @composio/core ai @ai-sdk/mcp @ai-sdk/openai
Install the Composio SDK and your agent framework
2

Create a session with MCP enabled

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

const composio = new Composio();
const { mcp } = await composio.create("your-user-id", {
  toolkits: ["podio"],
  mcp: true,
});
Create a session scoped to Podio and read its MCP URL and headers
3

Connect your agent to the MCP server

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();
Pass the session's MCP URL and headers to your agent and run a Podio request
SETUP GUIDE

Connect Podio API Tool with your Agent

1

Install Composio

typescript
npm install @composio/core @composio/openai openai
Install the Composio SDK, the OpenAI provider, and the OpenAI SDK
2

Create a Composio session

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();
Initialize Composio with the OpenAI Responses provider and create a session scoped to Podio
3

Run Podio tools with your agent

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);
Send a request, execute the Podio tool calls through the session, and print the final answer

Why Use Composio?

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

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

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

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

Rolling this out across your team?

Give your team centralized access control across every framework with Composio’s MCP Gateway.

EXPLORE MCP GATEWAY
FAQ

Frequently asked questions

Start with Podio.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Podio tool your agent needs.Free to start.

Start building