How to integrate Pivot MCP with Hermes

Connect Hermes to Pivot MCP. Create a pivot room for launch planning, list messages in the product room, and more using natural language, with authentication handled for you.

Pivot logoPivot
Api Key

Pivot is a team collaboration platform for organizations, spaces, rooms, messages, goals, and shared work. It keeps team communication and goals organized in one connected workspace.

71 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 Pivot 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.

Also integrate Pivot with

What is Composio Connect?

Composio Connect is a consumer offering that lets anyone plug 1,500+ 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 Pivot 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 Pivot

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

4. Done. You're all set with a new Pivot 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 Pivot or request any Pivot-related task. It will prompt you to authenticate and authorize access.

5. Done!

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

The Pivot MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Pivot account. It provides structured and secure access to organizations, spaces, rooms, members, groups, messages, labels, and shared work, so your agent can create collaboration spaces, manage access, retrieve team information, and work with shared content on your behalf.

  • Space and room management: Have your agent create, copy, retrieve, hide, or delete Pivot spaces, and create or look up rooms for chats, posts, calls, and streams.
  • Team access and invitations: Let the agent invite people to spaces or rooms, add existing users to groups and rooms, manage space membership, and review organization users and group members.
  • Shared work and responses: Direct your agent to create, list, update attachments for, and delete responses connected to shared Pivot blocks.
  • Labels and organization: Instruct your agent to create, list, add, or delete labels so teams can organize their Pivot spaces.
  • Collaboration details and cleanup: Have your agent retrieve room messages, recordings, spaces, blocks, and user context, or remove messages, spaces, users, and webhooks when needed.

Way Forward

With Pivot 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 Pivot action and event your agent gets out of the box.

Add Block Response Attachment

Attach an existing Pivot file to a block response.

Add Group Members

Add one or more existing Pivot users to a group.

Add Group To Space

Grant an existing Pivot group access to a space with specified space roles.

Add Room Members

Add one or more existing Pivot users to a room with a shared role.

Add Space Labels

Add one or more labels to a Pivot space without removing labels already assigned to it.

Add Space Members

Add one or more existing Pivot users to a space, optionally assigning space roles and member titles.

Copy Space

Start an asynchronous copy of a Pivot space.

Create Block Response

Create a Pivot block response from plain text, or use advanced rich content for formatting; optionally create it as a reply.

Create Block Sharing Rule

Create a sharing rule that grants a subject access to a Pivot block.

Create Label

Create a label in a Pivot organization.

Create Room

Create a Pivot chat, direct, post, audio, video, or streaming room.

Create Space

Create a blank Pivot space or organization template synchronously, or create an independent space from a template.

Create Space Role

Create a custom role in a Pivot space with an explicit set of permissions.

Create Subgoal

Create a goal directly under an existing Pivot goal.

Create Webhook

Create a Pivot webhook for an organization and return its one-time signing secret.

Delete Block Response

Delete a response from a Pivot block by its response UUID.

Delete Block Response Attachment

Delete a file attached to a block response by attachment UUID.

Delete Block Sharing Rule

Delete a sharing rule from a Pivot block by sharing-rule UUID.

Delete Label

Permanently delete a Pivot label by its label UUID.

Delete Room Message

Delete a sent Pivot room message.

Delete Space

Permanently delete a Pivot space or template using its ordinary space lifecycle.

Delete User

Permanently delete a Pivot user account, not merely remove a space membership.

Delete User or Remove Membership

Delete a Pivot user globally when the specified organization verified that user.

Delete Webhook

Permanently delete a Pivot webhook by its webhook UUID.

Get Block

Return a block by ID, optionally including all visible descendant blocks.

Get Room

Return a Pivot room by its ID.

Get Room Message

Retrieve one Pivot room message by its ID and send timestamp.

Get Room Recording

Return a specific Pivot room recording by ID, including transcript, chapter, summary, and caption assets.

Get Space

Return a Pivot space by ID with its settings, roles, member summaries, and labels.

Get Space Operation

Get the status of an asynchronous Pivot space copy or template application.

Get User Context

Return a Pivot user's profile, space memberships, and groups within an organization.

Hide Space

Hide an existing Pivot space from view.

Invite To Room

Invite people to a Pivot room by email.

Invite To Space

Invite people to a Pivot space by email.

List Block Responses

Return the responses attached to a Pivot block.

List Block Sharing Rules

Return the sharing rules configured for a Pivot block.

List Group Members

Return the users in a specified Pivot group.

List Groups

Return one page of groups in a Pivot organization.

List Labels

Return the labels configured in a Pivot organization.

List Organization Users

Return one page of users in a Pivot organization.

List Room Messages

Return one page of room messages, newest first.

List Room Recordings

Return one page of recordings for a Pivot room, including transcripts and other recording assets.

List Space Assignment Blocks

Return all assignment blocks in a Pivot space.

List Space Description Blocks

Return a space's description blocks and all of their descendants.

List Space Home Blocks

Return the blocks displayed on a Pivot space home.

List Space Members

Return one page of members in a Pivot space.

List Space Roles

Return the roles available in a Pivot space.

List Space Room Blocks

Return all room blocks and their parallel room metadata in a Pivot space.

List Spaces

Return one page of spaces visible in a Pivot organization.

List Thread Messages

Return one page of messages in a Pivot thread, oldest first.

List Webhook Logs

Return one page of delivery logs for a Pivot webhook.

List Webhooks

Return webhooks for a Pivot organization, optionally filtering by a case-insensitive substring of the webhook name.

Remove Group Members

Remove one or more users from a Pivot group.

Remove Space Label

Remove one label from a Pivot space by space and label UUID.

Remove Space Member

Remove a user from a Pivot space by space-member UUID.

Request Recording Download

Ensure a downloadable MP4 rendition exists for a Pivot room recording.

Revoke Organization Invite

Revoke a Pivot organization invitation by its invitation ID and email address.

Revoke Room Invite

Revoke a Pivot room invitation by room ID and email address.

Revoke Space Invite

Revoke a Pivot space invitation by organization, space, and email address.

Rotate Webhook Secret

Rotate the organization-wide webhook signing secret used for future Pivot webhooks.

Send Room Message

Send plain text or an advanced rich-content document to a Pivot room, optionally with file attachments or as a thread, inline, or recording reply.

Submit Block Response

Irreversibly submit a Pivot block response.

Update Block

Update exactly one property of a Pivot block: its hide time, unhide time, or space-member sharing level.

Update Block Response

Replace a Pivot block response with plain text, or use advanced rich content for formatting.

Update Block Sharing Rule

Set the access level for a user, group, space role, membership tier, or space identified by the subject of a sharing rule on a Pivot block.

Update Label

Update the name, color, or both for a Pivot label.

Update Room

Update one or more settings for a Pivot room, including its name, topic, type, and recording preferences.

Update Room Message

Replace a sent Pivot room message with plain text or an advanced rich-content document.

Update Space

Update one or more settings or metadata fields for an existing Pivot space.

Update Space Member

Update a Pivot space member's roles, title, status, or any combination of those fields.

Update Webhook

Update one or more properties of a Pivot webhook.

FAQ

Frequently asked questions

With a standalone Pivot MCP server, the agents and LLMs can only access a fixed set of Pivot tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from Pivot and many other apps based on the task at hand, all through a single MCP endpoint.

Yes, you can. Hermes fully supports MCP integration. You get structured tool calling, message history handling, and model orchestration while Tool Router takes care of discovering and serving the right Pivot tools.

Yes, absolutely. You can configure which Pivot scopes and actions are allowed when connecting your account to Composio. You can also bring your own OAuth credentials or API configuration so you keep full control over what the agent can do.

All sensitive data such as tokens, keys, and configuration is fully encrypted at rest and in transit. Composio is SOC 2 Type 2 compliant and follows strict security practices so your Pivot data and credentials are handled as safely as possible.

Start with Pivot.It takes 30 seconds.

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

Start building