How to integrate Raisely MCP with Codex

Trusted by
AWS
Glean
Zoom
Airtable

30 min · no commitment · see it on your stack

Raisely logo
Codex logo
divider

Introduction

Codex is one of the most popular coding harnesses out there. And MCP makes the experience even better. With Raisely MCP integration, you can draft, triage, summarise emails, and much more, all without leaving the terminal or the app, whichever you prefer.

Also integrate Raisely with

Why use Composio?

Apart from a managed and hosted MCP server, you will get:

  • CodeAct: A dedicated workbench that allows GPT to write its code to handle complex tool chaining. Reduces to-and-fro with LLMs for frequent tool calling.
  • Large tool responses: Handle them to minimise context rot.
  • Dynamic just-in-time access to 20,000 tools across 1000+ other Apps for cross-app workflows. It loads the tools you need, so GPTs aren't overwhelmed by tools you don't need.

How to install Raisely MCP in Codex

Run the setup command

Run this command in your terminal to add the Composio MCP server to Codex.

Terminal

It will initiate the authentication in a browser window, authorize Codex to access your Composio account.

Composio authentication page

(Optional) Authenticate with OAuth

To authenticate manually, run the login command to open a browser window and authorize Codex to access your Composio account.

bash
codex mcp login composio

Verify the connection

Run codex mcp list to confirm Composio appears as a registered MCP server.

bash
codex mcp list

Codex App

Codex App follows the same approach as VS Code.

  1. Click ⚙️ on the bottom left → MCP Servers → + Add servers → Streamable HTTP:
  2. Fill the header and Key fields with { "x-consumer-api-key" = "ck_*******" }.
  3. The Key is the Composio API key, that you can find on dashboard.composio.dev
  4. Click on Authenticate and authorize Codex to your Composio account and you're all set.
Codex App MCP setup
  1. Restart and verify if it's there in .codex/config.toml
bash
[mcp_servers.composio]
url = "https://connect.composio.dev/mcp"
http_headers = { "x-consumer-api-key" = "ck_*******" }

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

The Raisely MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Raisely account. It provides structured and secure access to your fundraising campaigns, so your agent can perform actions like listing campaigns, managing profiles, retrieving fundraising posts, and overseeing users or webhook subscriptions on your behalf.

  • Campaign discovery and management: Instantly fetch and list all your Raisely campaigns, making it easy to organize or review ongoing fundraising efforts.
  • Profile and supporter insights: Retrieve detailed fundraising profiles within any campaign, or list all supporter profiles to track progress and engagement.
  • Posts and communications access: Pull all posts published on the Raisely platform, allowing your agent to keep you updated or summarize campaign communications.
  • User administration: Get a comprehensive list of users on your platform or drill into user-specific fundraising profiles, streamlining supporter management.
  • Webhook and event monitoring: View all configured webhook subscriptions and available event types, helping you automate notifications and stay on top of campaign activity.

Supported Tools & Triggers

Tools
Check Profile URL AvailabilityTool to verify if a profile URL is available for a given campaign and get suggestions if unavailable.
Check User RegistrationTool to check if a user is already registered to a campaign with a specific email address.
Create CampaignTool to create a new campaign in Raisely.
Create Offline DonationTool to record an offline donation in Raisely.
Create Exercise LogTool to create a new exercise log in Raisely.
Create InteractionTool to create a new interaction in Raisely.
Create PostCreate a new post in Raisely.
Create Promo CodeTool to create a new promo code in Raisely.
Create WebhookTool to add a new webhook to your Raisely account.
Delete Exercise LogTool to delete an exercise log from Raisely.
Delete InteractionTool to delete an existing custom interaction from Raisely.
Delete Raisely PostTool to delete a post from the Raisely platform.
Delete ProfileTool to archive a profile in Raisely.
Delete Raisely WebhookTool to delete a webhook from the Raisely platform.
Retrieve Raisely API Documentation SummaryRetrieve a summary of the Raisely API documentation including metadata and sample endpoints.
Authenticate TokenAuthenticate a token to confirm it's valid and check the logged-in user.
Get Available EventsTool to retrieve a list of available Raisely webhook events.
Get CampaignTool to retrieve a specific campaign from Raisely.
Get Campaign ProfileTool to retrieve the campaign profile for a Raisely campaign.
Get campaignsTool to retrieve a paginated list of campaigns from Raisely.
List Campaign ProfilesList all fundraising profiles in a Raisely campaign.
Get Exercise LogRetrieve a specific exercise log by UUID from the Raisely platform.
Get InteractionTool to retrieve a specific interaction from Raisely by its UUID.
Get PostTool to retrieve a specific post from the Raisely fundraising platform.
Get ProfileRetrieves a specific fundraising profile from Raisely by UUID or path.
Raisely Get ProfilesRetrieves a paginated list of fundraising profiles for a Raisely campaign.
Get UserTool to retrieve a specific user from Raisely by UUID.
Get User ProfilesTool to retrieve all profiles associated with a specific user.
Get UsersRetrieve a paginated list of users from the Raisely platform.
List Campaign DonationsTool to retrieve donations from a specific campaign in Raisely.
List Campaign ProductsRetrieves all products available in a Raisely campaign.
List Campaign SubscriptionsList all subscriptions for a specific Raisely campaign.
Raisely List DonationsRetrieve donations from Raisely.
Raisely List Exercise LogsRetrieve exercise logs from Raisely.
List Interaction CategoriesTool to retrieve all interaction categories in the organisation from Raisely.
List InteractionsTool to retrieve all interactions from Raisely.
List OrdersTool to retrieve all orders in a campaign from Raisely.
List PostsTool to retrieve a list of posts you've previously created on Raisely.
List Profile DonationsRetrieves a paginated list of donations for a specific fundraising profile from Raisely.
List Profile MembersRetrieves a paginated list of all members belonging to a team profile in Raisely.
List Profile PostsList all posts created by a specific profile in Raisely.
List Promo CodesTool to retrieve all promo codes in a campaign from Raisely.
List SegmentsTool to retrieve all segments from Raisely.
Raisely List Subscriptions 2Tool to retrieve subscriptions from Raisely.
List TagsTool to retrieve the list of tags from Raisely.
List User DonationsRetrieves a paginated list of donations for a specific user from Raisely.
List User InteractionsRetrieves all interactions for a given user from Raisely.
Raisely List User SubscriptionsRetrieve subscriptions for a specific user from Raisely.
List WebhooksTool to retrieve the list of webhooks configured for a campaign.
Move DonationTool to move a donation to a different profile in Raisely.
Logout from RaiselyTool to invalidate the current user's token and log out.
Create UserCreate a new user in Raisely.
Update CampaignTool to update an existing campaign in Raisely.
Update Campaign ConfigTool to update a specific configuration attribute for a campaign in Raisely.
Update Exercise LogUpdate an existing exercise log in Raisely.
Update PostTool to update a specified post in Raisely.
Update ProfileUpdates a specific profile in Raisely.
Update UserTool to update a specified user in Raisely.
Update WebhookTool to update a specified webhook in Raisely.
Upload Campaign MediaTool to upload one or more files to a campaign's media library in Raisely.
Upsert UserTool to upsert a user record in Raisely, optionally tagging and creating an interaction.

Conclusion

You've successfully integrated Raisely with Codex using Composio's MCP server. Now you can interact with Raisely directly from your terminal, VS Code, or the Codex App using natural language commands.

Key benefits of this setup:

  • Seamless integration across CLI, VS Code, and standalone app
  • Natural language commands for Raisely operations
  • Managed authentication through Composio
  • Access to 20,000+ tools across 1000+ apps for cross-app workflows
  • CodeAct workbench for complex tool chaining

Next steps:

  • Try asking Codex to perform various Raisely operations
  • Explore cross-app workflows by connecting more toolkits
  • Build automation scripts that leverage Codex's AI capabilities

How to build Raisely MCP Agent with another framework

FAQ

What are the differences in Tool Router MCP and Raisely MCP?

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

Can I use Tool Router MCP with Codex?

Yes, you can. Codex 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 Raisely tools.

Can I manage the permissions and scopes for Raisely while using Tool Router?

Yes, absolutely. You can configure which Raisely 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.

How safe is my data with Composio Tool Router?

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 Raisely data and credentials are handled as safely as possible.

Used by agents from

Context
Letta
glean
HubSpot
Agent.ai
Altera
DataStax
Entelligence
Rolai
Context
Letta
glean
HubSpot
Agent.ai
Altera
DataStax
Entelligence
Rolai
Context
Letta
glean
HubSpot
Agent.ai
Altera
DataStax
Entelligence
Rolai

Never worry about agent reliability

We handle tool reliability, observability, and security so you never have to second-guess an agent action.