Pivot MCP server for AI agents and assistants

Securely connect your AI agents and chatbots (Claude, ChatGPT, Cursor, etc) with Pivot MCP or direct API to manage spaces, create rooms, post messages, track goals, and organize members through natural language.

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

Try Pivot now

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

TOOL ROUTER PLAYGROUND
Pivot
Try asking
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.

SETUP GUIDE

Connect Pivot 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: ["pivot"],
  mcp: true,
});
Create a session scoped to Pivot 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 room named Product Launch in my Pivot workspace",
  stopWhen: stepCountIs(10),
});

console.log(text);
await client.close();
Pass the session's MCP URL and headers to your agent and run a Pivot request
SETUP GUIDE

Connect Pivot 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: ["pivot"] });
const tools = await session.tools();
Initialize Composio with the OpenAI Responses provider and create a session scoped to Pivot
3

Run Pivot tools with your agent

typescript
let response = await client.responses.create({
  model: "gpt-5.6-sol",
  tools,
  input: [{ role: "user", content: "Create a room named Product Launch in my Pivot 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 Pivot tool calls through the session, and print the final answer

Why Use Composio?

AI Native Pivot Integration

  • Supports both Pivot MCP and direct API based integrations
  • Structured, LLM-friendly schemas for reliable tool execution
  • Rich coverage for reading, writing, and querying Pivot organizations, spaces, rooms, messages, goals, and members

Secure API Key Handling

  • Connect Pivot with API keys without embedding credentials in agent prompts or application code
  • Central place to manage, scope, and revoke Pivot access
  • Per user and per environment credentials for safer team workflows

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 Pivot
  • Scoped, least privilege access to Pivot 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

Yes, Pivot requires you to configure your own API key. Once set up, Composio handles secure credential storage and API request handling for you.

Yes! Composio's Tool Router enables agents to use multiple toolkits. Learn more.

Yes. Composio is SOC 2 Type II compliant and is built to keep your Pivot connection and credentials secure. OAuth tokens and API keys are encrypted, and sensitive customer data is protected at rest and in transit.

Composio also undergoes independent security testing and continuously monitors its systems for security threats. You can review the latest reports and policies in the Composio Trust Center.

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

Create the key in your Pivot account settings, then paste it once on Composio's connection page. Composio stores it encrypted and uses it only for the Pivot actions your agent runs. Nobody else in your workspace can read it, and you can revoke it inside Pivot at any time.

When you connect a Pivot account through Composio, every action runs under that account, so anything the agent creates, sends, or changes shows up in Pivot as done by you. Keep an approval step in your prompt for actions with side effects, such as sending or deleting, and have the agent draft first.

Whatever the credentials you connect allow inside Pivot. If Pivot lets you scope a key to specific permissions, create a scoped one so the agent can only do what you intend. You can revoke the key inside Pivot at any time.

Yes. Composio supports multiple connected accounts for the same app, and that works in Claude, ChatGPT, or any other assistant you connect through Composio. Give each Pivot connection a name such as work or personal, and the assistant uses the one you mention in the request. Each account keeps its own credentials and nothing is merged.

The connection stops working the moment Pivot rejects the old key. Create a new key in Pivot and reconnect the account from the Composio dashboard or by asking your agent to reconnect Pivot. Nothing else changes.

Composio's free Hobby plan includes 100,000 tool calls per month with no credit card, which covers most personal Pivot use. Paid plans add higher limits and team features. Your Pivot plan and its API limits still apply as usual.

Built-in connectors usually give one AI access to a limited set of apps. Many people use Composio because it lets their AI connect to more apps than it normally supports, or connect to multiple accounts for the same app (e.g. connect Claude to multiple Pivot accounts).

With Composio, you connect Pivot once and then use it across different AI assistants without setting it up separately in each one. Connect your apps to Composio once, then connect Composio to whichever AI you use, whether that's Claude, ChatGPT, Hermes, or your own custom assistant.

Start with Pivot.It takes 30 seconds.

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

Start building