The Cube MCP Server lets you connect your governed financial data directly to AI platforms like Claude and ChatGPT. Instead of exporting data and pasting it into AI chats, the MCP Server provides a live, secure connection that respects your Cube permissions on every request.
Overview
With the Cube MCP Server, you can:
- Query live Cube data from Claude, ChatGPT, and other MCP-compatible AI tools: actuals, budgets, forecasts, variances, and more
- Ask an AI to generate board decks, run variance analysis, or build financial summaries using your real Cube data
- Drill into transaction-level detail and dimension breakdowns directly from an AI chat
Maintain full security: Cube's role-based access control (RBAC) security model enforces your user permissions on every AI request. If you can't see it in Cube, the AI can't see it either
How it works
The Model Context Protocol (MCP) is an open standard that lets AI tools connect to external data sources. Cube's MCP Server acts as a secure gateway between your AI tool and your Cube data.
When you (or an AI agent acting on your behalf) send a query through MCP, Cube validates your identity, checks your Data Access Scope, and returns only the data you are authorized to see. The AI tool receives governed, calculated, multi-currency-normalized financials, not raw exports.
This means:
- Every response uses your Cube Source of Truth: consolidated, calculated, and current
- Your Cube business rules, formulas, and multi-currency logic are applied before data reaches the AI
- No data leaves Cube without passing through your organization's permission model
Prerequisites
Before connecting, confirm the following:
- You have a Cube account with an active login.
- You have access to an AI tool that supports MCP connectors. Note that MCP functionality may require a specific subscription tier depending on the tool:
- Claude: MCP connectors are available on Claude Pro, Team, and Enterprise plans. Free plans do not support custom connectors. Check Anthropic's plan details for the latest information.
- ChatGPT: MCP connectors require a Plus, Pro, Team, Business, Enterprise, or Edu plan. Developer Mode must be enabled by a workspace admin for Business and Enterprise plans. Check OpenAI's plan details for the latest information.
- Other tools: Refer to your tool's documentation for MCP support and plan requirements.
Connect to Claude
- Go to claude.ai/settings/connectors.
- Click Add custom connector.
- Enter the following:
- Name: Cube
- URL:
https://mcp.cubesoftware.com/
- Click Add.
- You will be prompted to authenticate with Cube via OAuth. Sign in with your Cube credentials.
- Once connected, Cube will appear in your list of connectors.
Start querying:
Open a new conversation in Claude and ask a question about your financial data. Examples:
- "Build me a board deck showing this quarter's performance. Include revenue by quarter, gross margin trends, opex breakdown by department, and headcount growth. Compare actuals to budget."
- "Create a summary comparing Actuals vs. Forecast for Revenue by entity for the last 12 months."
- "If we cut Sales & Marketing spend by 15% in the back half of the year, how would that change our Net Income? Compare to what we actually spent."
Claude will call the Cube MCP Server to retrieve your data, apply your permissions, and return results grounded in your Source of Truth.
Connect to ChatGPT
ChatGPT supports custom MCP connectors through its Apps & Connectors settings. This feature requires a ChatGPT Plus, Pro, Team, Business, Enterprise, or Edu plan.
You can add Cube directly as a ChatGPT app instead of creating a custom connector. This is the fastest way to get started.
Requirements: ChatGPT Plus, Pro, Team, Business, Enterprise, or Edu plan.
- Open this link: Add Cube to ChatGPT
- ChatGPT will open the Cube app page. Click Connect.
- Review the permissions summary, then click Continue to Cube.
- Sign in with your Cube credentials to authorize the connection.
- Once connected, Cube will appear in your list of apps under Settings > Apps & Connectors.
- To start querying, open a new chat, click the + button (or Connected apps) in the chat tools menu, enable Cube, and ask a question about your financial data.
If you prefer to configure the connection manually, or if the app link above doesn't work for your ChatGPT plan, follow the steps below.
Step 1: Enable Developer Mode
- In ChatGPT, go to Settings > Apps & Connectors > Advanced settings.
- Enable the Developer Mode toggle.
Step 2: Add the Cube connector
- Return to Settings > Apps & Connectors.
- Click Create (or + Create New Connector).
- Enter the following:
- Name: Cube
- Description: Query governed financial data from Cube, including actuals, budgets, forecasts, variances, and transaction-level detail.
- MCP Server URL:
https://mcp.cubesoftware.com/ - Authentication: OAuth
- Check the box to confirm you trust this application.
- Click Create.
- You will be redirected to Cube's login page. Sign in with your Cube credentials to authorize the connection.
- Once connected, Cube will appear in your list of connectors under Apps & Connectors.
Step 3: Start querying
- Open a new chat in ChatGPT.
- Click the + button (or Connected apps) in the chat tools menu and enable the Cube connector.
- Ask a question about your financial data. Examples:
- "Use deep research to analyze our company's financial performance in the context of current market conditions. Pull our revenue, margins, and opex from Cube, then research comparable SaaS benchmarks and write a board-ready market positioning report."
- "Pull our quarterly P&L from Cube for 2024 and 2025 and open it in Canvas. Build a variance analysis with charts showing actuals vs budget by department, and let me edit the commentary inline before exporting to PDF."
- "Connect to Cube and pull our current headcount, personnel costs, and revenue by department. Then model three scenarios: (1) 10% RIF in Sales, (2) 20% Engineering hiring ramp, (3) flat headcount with 5% raises. Show the net income impact of each."
ChatGPT will display a confirmation prompt before executing any tool call, so you can review what data is being requested.
Troubleshooting an "Unknown Tool" related error:
- Click your name in the lower left-hand corner of the screen.
- Select Settings from the menu.
- Select Apps from the new window.
- Select Cube from your list of apps.
- You see something that says Information. To the right of that, there should be a Refresh button. Click that button.
Connect to other MCP-compatible tools
The Cube MCP Server works with any tool that supports the Model Context Protocol. The general pattern is:
- Open your tool's MCP or Connectors settings.
- Add a new connector with the URL
https://mcp.cubesoftware.com/. - Authenticate with your Cube credentials when prompted.
Refer to your specific tool's MCP documentation for exact configuration steps.
Things to keep in mind
- Every MCP request is validated against your Cube user permissions. There are no master keys or backdoors.
- AI agents cannot rename dimensions, restructure hierarchies, or write directly to source systems through Cube.
- The MCP Server delivers governed, calculated data. Cube's rules engine, multi-currency logic, and multi-source consolidation are applied before data reaches any AI tool.
- If your Data Access is modified in Cube, the change takes effect on the next MCP request in real time.
- AI tools may interpret or summarize data in their responses. Always verify AI-generated content against your Cube Source of Truth before using it in formal reporting or decision-making.
- AI tools may interpret or summarize data in their responses. Always verify AI-generated content against your Cube Source of Truth before using it in formal reporting or decision-making.
- See how to get started with example prompts here.
Troubleshooting
- If your connection has stopped working, or is presenting unexpected errors, try to disconnect and reconnect to the server. If that doesn't work, contact our Support team.