Use the Model Context Protocol (MCP) to connect your Perdoo account with ChatGPT, Claude, Perplexity, or any MCP-compatible tool.
Configuring the Perdoo MCP server
ChatGPT / OpenAI
Sign into your paid ChatGPT account
Turn on Developer Mode
Go to Settings > Apps > Advanced Settings > Create app
Fill in the connector details
Name: Perdoo
MCP Server URL: https://mcp.perdoo.com
Authentication: OAuth
Advanced settings > OAuth Client ID: 7QSbCViY5hsv1Br6ZNVmWq30U0ps56gLpWYRVRjZ
Click Create
Claude
Sign into your paid Claude account
Go to Settings > Connectors
Click Add custom connector
Fill in the connector details:
Name: Perdoo
Remote MCP server URL: https://mcp.perdoo.com
Advanced settings > OAuth Client ID: 7QSbCViY5hsv1Br6ZNVmWq30U0ps56gLpWYRVRjZ
Add
Go to Settings > Connectors
Find Perdoo, click Connect and then Authorize
You'll see in the top-right corner that you're connected to Perdoo!
Perplexity
Click on + Custom connector
Fill in the connector details:
Name: Perdoo
MCP Server URL: https://mcp.perdoo.com
Advanced > OAuth > Client ID: 7QSbCViY5hsv1Br6ZNVmWq30U0ps56gLpWYRVRjZ
Click Add
Click on the connector to authorize your Perdoo account
After a successful authorization, you should see this message:
Available tools
Tool | Description |
get_me | Get the currently authenticated user's profile |
get_company | Get the currently authenticated user's profile |
list_okrs | List OKRs (Objectives together with their Key results) |
list_objectives | List OKR objectives with optional filters, progress, and status |
get_objective | Get a single objective by ID, including k Key results, lead, timeframe, and tags |
list_results | List Key results and Initiatives |
get_result | Get a single Key result or Initiative by ID |
list_kpis | List KPIs (Key Performance Indicators) with optional filters |
get_kpi | Get a single KPI by ID, including lead, teams, tags, and current value |
list_strategic_pillars | List Strategic pillars with optional filters |
get_strategic_pillar | Get a single strategic pillar by ID, including children and progress details |
list_teams | List teams with optional filters |
get_team | Get a single team by ID, including members, sub-teams, and parent |
list_users | List users/team members with optional filters |
list_timeframes | List timeframes (planning periods) with optional filters |
list_reviews | List reviews |
list_updates | List progress updates (value changes on goals) |
search_all | Search across all Perdoo entities (objectives, key results, KPIs, users, teams, etc.) |
Example prompts
Which of my team's OKRs are off track this quarter?
The model calls `list_timeframes` to find the current timeframe, then `list_okrs` with `stage=ACTIVE` and `status=BEHIND` to retrieve at-risk Objectives and their Key results.
Summarize progress on our 'Expansion Strategy' strategic pillar.
The model calls `search_all` with `query="Expansion Strategy"` to locate the pillar, then `get_strategic_pillar` with its ID to retrieve the full pillar, its child Objectives, and rolled-up progress.
Who leads the Engineering team and what KPIs do they own?
The model calls `list_teams` with `nameContains="Engineering"`, follows up with `get_team` to list members and the team lead, then `list_kpis` with the lead's `leadId` to return their active KPIs and current values.
Show my most recent progress update and which key result it belongs to.
The model calls `get_me` to identify the current user, then `list_updates` with that `userId` ordered by `commitDate` to return the latest update and the Key result it applies to.
Have a question?
Contact our friendly Support team via the in-app chat at the bottom-right of your screen, or email support@perdoo.com.