How to integrate Pivot MCP with Atomic Agent

Connect Atomic Agent 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

Atomic Agent is an open-source AI agent that runs on your machine and supports local models through llama.cpp. Connect it to 1,500+ apps through Composio, including Pivot.

This guide uses Atomic Agent's built-in Composio integration. You need Atomic Agent v0.5.6 or later, your own Composio API key, and a Pivot account. See the Atomic Agent documentation for installation instructions.

Also integrate Pivot with

How Atomic Agent connects to Pivot

Atomic Agent connects to Composio's Tool Router over Streamable HTTP MCP. It discovers the tools needed for your request, and Composio handles account authentication.

Execution and account-connection tools follow Atomic Agent's configured approval policy. Review any approval prompt before allowing an action on your connected account.

Connect Pivot to Atomic Agent

  1. Sign up or sign in to the Composio dashboard. Copy your API key.
  2. In Atomic Agent, open the Integrations tab and select Composio. Select API key, press e, paste the key, and press Enter. The tools become available immediately, without a restart.
  3. Ask Atomic Agent to do something in Pivot. It searches Composio for the right tool.
  4. On first use, open the sign-in link returned in the chat. Connect your Pivot account, then return to Atomic Agent to continue.

Headless setup

Add the following line to ~/.atomic-agent/.env, replacing YOUR_COMPOSIO_API_KEY with your key. Start Atomic Agent after saving the file.

bash
COMPOSIO_API_KEY=YOUR_COMPOSIO_API_KEY

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.

Use Pivot from Atomic Agent

With your account connected, ask Atomic Agent to work with Pivot in natural language. You can connect more apps through the same Composio integration as you need them.

Visit the Atomic Agent website or inspect the Atomic Agent source code.

Troubleshooting

Why is my API key rejected?

Copy the key directly from the Composio dashboard. Atomic Agent requires ASCII characters because it sends the key in an HTTP header. Remove any extra characters introduced when copying.

Why are Composio tools unavailable after saving a key?

Check that you use Atomic Agent v0.5.6 or later and that Composio is enabled in your configuration. A "composio": { "enabled": false } setting disables the integration while keeping the saved key on disk.

Does Composio have a free plan?

The Hobby plan includes 100,000 tool calls per month. Composio-managed OAuth apps have a lower included allowance. See Composio pricing for the current limits that apply to your connection.

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. Atomic Agent 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