X (Twitter)LinkedInGitHubDiscordYouTube

How to connect Revolt to Claude

Connect Claude Web, Desktop and Cowork to Revolt MCP. Fetch profile details for user by id, list all flags assigned to this user, and more using natural language, with authentication handled for you.

Get started for freeGet a demo
Revolt logoRevolt
Api Key

Revolt is a free, open-source chat platform for secure, customizable group and 1:1 messaging. Enjoy privacy-first conversations and seamless team collaboration without vendor lock-in.

26 Tools

Introduction

Claude is Anthropic's AI assistant, available on the web, in the desktop app, and on mobile. Cowork is its agent for knowledge work, and it runs on all of those surfaces too. Connected to your apps, Claude can work with your files and services to accomplish complex tasks on your behalf.

This guide walks you through the easiest and most secure way to connect your Revolt account to Claude via Composio Connect, enabling it to fetch profile details for user by ID, list all flags assigned to this user, update your status message to 'In a meeting', and more such actions on your behalf without compromising your account security.

Setup is the same on Claude Web, Desktop, and Cowork, and you only need to do it once. The connector is tied to your account, so it's available in all three.

Also integrate Revolt with

OpenAI Agents SDKClaude Agent SDKClaude CodeCodexOpenClawHermesAtomic AgentGoogle ADKLangChainVercel AI SDKMastra AILlamaIndexCrewAIPydantic AIAutoGen

Connecting Revolt to Claude Web, Desktop, and Cowork

Two ways to add the Composio connector. Pick whichever you prefer.

1. Add with one click

Click the button. Claude opens with the Composio connector filled in. Click Add, then go to step 2.

Add to Claude

Add manually

In Claude Desktop, click Customize in the left sidebar, then select Connectors and click the + icon at the top.

Claude Desktop connectors screen with Add custom connector selected

Click Add custom connector and paste in the Composio MCP server URL:

bash
https://connect.composio.dev/mcp
Add custom connector dialog with Composio MCP server URL

2. Authorize in your browser

Click Connect. You'll be redirected to a browser window where you can authorize Composio to continue.

Composio authorization screen for Claude Web, Desktop, and Cowork

3. Connect your Revolt account

Back in Claude, ask it to connect to Revolt or give it any Revolt-related task.

For example, ask Claude to:

  • "Fetch profile details for user by ID"
  • "List all flags assigned to this user"
  • "Update your status message to 'In a meeting'"

It will prompt you to authenticate and authorize access.

That's it. Composio's tools are now available in Claude, and your Revolt account is ready to use.

What is the Revolt Claude Connector, and what's possible with it?

The Revolt MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Revolt account. It provides structured and secure access to your chat platform, so your agent can perform actions like retrieving user details, inspecting special user flags, and updating user profiles on your behalf.

  • User profile retrieval: Instantly fetch detailed information about any user by providing a valid user ID, making it easy to manage accounts and view profile data.
  • User flag inspection: Allow your agent to access and display special flags or roles associated with specific users, helping you understand permissions or statuses at a glance.
  • User profile updates: Quickly update a user's profile or status fields directly from your agent, streamlining administrative and personalization tasks.
  • Automated user management: Enable your agent to handle user account lookups and modifications, reducing manual effort and improving efficiency in managing your Revolt community.

Troubleshooting

1. Why does Claude not use the Composio connector for Revolt?

The connector can show as connected, but Claude must use it in each Revolt conversation.

  • Click + at the lower left of the chat, or type /.
  • Hover Connectors.
  • Turn on Composio.
  • Ask Claude to connect to Revolt again.

2. Why does Claude show an MCP server error before Revolt connects?

Claude can show Couldn't reach the MCP server or Authorization with the MCP server failed when you add the connector for Revolt.

  • Check that the connector URL is https://connect.composio.dev/mcp.
  • Connectors run from Anthropic's cloud, so your device network is usually not the problem.
  • Add the connector again from Customize > Connectors, then ask Claude to connect Revolt.
  • If it fails again, send the error and the ofid_ reference id to support@composio.dev.

3. Why does the Revolt authorization link not work?

The Composio connector is one server. Your Revolt account connects separately when Claude asks for it.

  • If the browser does not open, or the link expires, ask Claude to retry the Revolt connection.
  • Composio creates a fresh Revolt authorization link.
  • Open that link in your browser and finish the Revolt sign-in.

4. Why do Revolt actions fail after they worked before?

The Revolt connection can expire or lose permission.

  • Ask Claude to inspect the Revolt connection.
  • If the connection is unhealthy, disconnect it when Claude prompts you.
  • Reconnect the Revolt account and retry the action.
  • If Claude shows a permission prompt, approve it before Claude changes data in Revolt.
  • If the action still fails with a permission error, check that the connected account has that permission in Revolt itself.

5. How do I switch to a different Revolt account?

Claude can manage the Revolt connection for you.

  • Ask Claude to disconnect or delete the current Revolt account.
  • Ask Claude to connect Revolt again.
  • Open the new Composio authorization link for Revolt.
  • Sign in with the other Revolt account in the browser.
  • After the account connects, ask Claude to retry the Revolt task.

6. Why is my Revolt connection missing in Claude Desktop or on a Team plan?

The connector belongs to your Claude account, so your Revolt connection works in Claude Web, Desktop, and Cowork.

  • In Claude Desktop, open Customize > Connectors.
  • Next to Composio, click ⋮ and click Clear cache.
  • If Revolt tools still do not appear, click ⋮, disconnect, remove the connector, and add it again.
  • On Team or Enterprise, an Owner or Primary Owner must enable the connector before you can connect Revolt.
TOOLS

Supported Tools

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

Acknowledge Policy Changes

Tool to acknowledge platform policy changes.

Add Reaction to Message

Tool to add a reaction to a message in a channel.

Block User

Tool to block another user by their ID.

Create Sync Settings

Tool to upload and save settings data to Revolt's sync storage.

Delete Message

Tool to delete a message you've sent or one you have permission to delete.

Bulk Delete Messages

Tool to bulk delete multiple messages from a channel.

Fetch Owned Bots

Tool to fetch all bots that you have control over.

Fetch Sync Settings

Tool to fetch settings from server filtered by keys.

Fetch user

Tool to fetch detailed information about a user.

Fetch User Flags

Tool to fetch flags associated with a specific user.

Get API Info

Tool to fetch the server configuration for this Revolt instance.

Get Channel

Tool to fetch a channel by its ID.

Get Current User

Tool to retrieve your own user information.

Get Invite

Tool to fetch detailed information about an invite by its code.

Get Sync Unreads

Tool to fetch information about unread state on channels.

Get User Profile

Tool to retrieve a user's profile data including bio and background.

Get User's Default Avatar

Tool to fetch a user's default avatar image based on their ID.

Open DM with User

Tool to open a DM with another user.

Get User DMs

Tool to fetch all direct message conversations for the authenticated user.

Pin Message

Tool to pin a message in a channel by its ID.

Remove Message Reaction

Tool to remove a reaction from a message.

Send Channel Message

Tool to send a message to a Revolt channel.

Unblock User

Tool to unblock another user by their ID.

Unpin Message

Tool to unpin a message in a channel.

Update Channel Message

Tool to edit a message that you've previously sent in a channel.

Update User

Tool to update user information.

FRAMEWORKS

How to build Revolt MCP Agent with another framework

OpenAI Agents SDK logo

OpenAI Agents SDK

Use Revolt MCP with OpenAI Agents SDK

Claude Agent SDK logo

Claude Agent SDK

Use Revolt MCP with Claude Agent SDK

Claude Code logo

Claude Code

Use Revolt MCP with Claude Code

Codex logo

Codex

Use Revolt MCP with Codex

OpenClaw logo

OpenClaw

Use Revolt MCP with OpenClaw

Hermes logo

Hermes

Use Revolt MCP with Hermes

Atomic Agent logo

Atomic Agent

Use Revolt MCP with Atomic Agent

Google ADK logo

Google ADK

Use Revolt MCP with Google ADK

LangChain logo

LangChain

Use Revolt MCP with LangChain

Vercel AI SDK logo

Vercel AI SDK

Use Revolt MCP with Vercel AI SDK

Mastra AI logo

Mastra AI

Use Revolt MCP with Mastra AI

LlamaIndex logo

LlamaIndex

Use Revolt MCP with LlamaIndex

CrewAI logo

CrewAI

Use Revolt MCP with CrewAI

Pydantic AI logo

Pydantic AI

Use Revolt MCP with Pydantic AI

AutoGen logo

AutoGen

Use Revolt MCP with AutoGen

FAQ

Frequently asked questions

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

Yes, you can. Claude Cowork 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 Revolt tools.

Yes, absolutely. You can configure which Revolt 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 Revolt data and credentials are handled as safely as possible.

Start with Revolt.It takes 30 seconds.

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

Start building