How to integrate Podio MCP with Hermes

Connect Hermes to Podio MCP. Create tasks from new podio items, find overdue tasks across your podio workspaces, and more using natural language, with authentication handled for you.

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

Introduction

Hermes is a 24/7 autonomous agent that lives on your computer or server — it remembers what it learns and evolves as your usage grows.

This guide explains the easiest and most robust way to connect your Podio account to Hermes. You can do this through either Composio Connect CLI or Composio Connect MCP. For personal use we recommend the CLI, but you won't go wrong with MCP either.

For exact tool slugs and parameter tables, see the tool catalog in the Composio docs.

Also integrate Podio with

What is Composio Connect?

Composio Connect is a consumer offering that lets anyone plug 1,700+ applications directly into their agent harness — including Hermes. It can:

  • Search and load tools from relevant toolkits on-demand, reducing context usage.
  • Chain multiple tools to accomplish complex workflows via a remote workbench, without excessive back-and-forth with the LLM.
  • Manage app authentication end-to-end with zero manual overhead.

Integrating Podio with Hermes

Using Composio Connect CLI

1. Install the Composio CLI

Run the install script directly, or paste https://composio.dev/hermes into your Hermes chat box to have it installed for you.

bash
curl -fsSL https://composio.dev/install | bash
Hermes authenticating with Composio

2. Authenticate

Once the CLI is installed, ask Hermes to authenticate with Composio.

3. Connect to Podio

Ask your agent to connect to Podio, or simply request any Podio-related task. Hermes will prompt you to authenticate and authorize access.

4. Done. You're all set with a new Podio connection.


Using Composio Connect MCP

1. Get your MCP URL and API Key

Go to dashboard.composio.dev and copy your Connect MCP URL and API key.

Copy MCP URL and API key from Composio dashboard

2. Open the Hermes config file

bash
nano ~/.hermes/config.yaml

3. Add the Composio Connect MCP server

bash
mcp_servers:
  composio:
    url: "https://connect.composio.dev/mcp"
    headers:
      x-consumer-api-key: "YOUR_COMPOSIO_API_KEY"
    connect_timeout: 60
    timeout: 180

Save with Ctrl + O, Enter, then exit with Ctrl + X.

4. Restart your Hermes agent

Once restarted, ask your agent to connect to Podio or request any Podio-related task. It will prompt you to authenticate and authorize access.

5. Done!

What is the Podio MCP server, and what's possible with it?

The Podio MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Podio account. It provides structured and secure access to your Podio apps, workspaces, items, tasks, comments, and organization data, so your agent can create and find work items, manage tasks, organize app workflows, and coordinate team activity on your behalf.

  • App and workspace management: Have your agent find app details, create apps and fields, activate or deactivate apps, and create or archive workspaces.
  • Item and workflow management: Let the agent create, clone, filter, calculate, export, and delete items across your Podio apps.
  • Task coordination: Direct your agent to create tasks, assign them to users, add labels and due dates, mark tasks complete, or remove tasks that are no longer needed.
  • Team collaboration: Instruct your agent to add comments to Podio items and tasks, attach files or links, and remove comments when needed.
  • Organization administration: Have your agent create organizations, look up administered organizations, manage organization spaces and member roles, and end organization memberships.

Way Forward

With Podio connected, Hermes can now act on your behalf whenever it detects a relevant task or you ask it to.

From here, you can extend Hermes further:

  • Connect more apps: Calendar, Slack, Notion, Linear, and hundreds of others are available through the same Composio Connect setup. Each new integration compounds what Hermes can do for you.
  • Build workflows across tools: Once multiple apps are connected, Hermes can chain actions together — turn an email into a calendar invite, a Slack message into a Linear ticket, or a meeting note into a follow-up draft.
  • Let it learn your patterns: The more you use Hermes, the better it gets at anticipating how you'd handle recurring tasks. Give it feedback on drafts and decisions, and it will adapt.

If you run into trouble or want to share what you've built, join the community or check out the Docs for deeper configuration options.

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.

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