Perdoo

Read and manage Perdoo OKRs, KPIs, goals and progress updates from any MCP client.

Hosted MCP Server

npx add-mcp 'https://mcp.perdoo.com/'

Installs into Claude Code, Codex, Cursor and more

Documentation

ℹ️ Available on Premium and Supreme.

Use Perdoo's MCP (Model Context Protocol) server to connect your Perdoo account to ChatGPT, Claude, Copilot, Gemini, Perplexity — or any other MCP-compatible tool.

How to configure the MCP server

You'll find specific instructions for ChatGPT, Claude, Copilot, Gemini, and Perplexity below. The generic instructions are as follows:

Server URL: https://mcp.perdoo.com
Authentication: OAuth or API key
- OAuth > Client ID: 7QSbCViY5hsv1Br6ZNVmWq30U0ps56gLpWYRVRjZ
- API key: Go to Personal settings > API tokens to create an API key.

You can use the below image as the icon for the app/connection:

ChatGPT

Click Connect

Claude

Click on our Claude connector or Personal settings > Integrations > Claude
Click Connect to Claude

Authorize the MCP
You'll see 'Connected' once successful.

Copilot

In Teams or Copilot, go to Apps, search “Perdoo” and click Add.
- If the app doesn’t show up, your Microsoft IT Admin has to allow it first.
Inside Copilot chat, turn on Perdoo.
Click Connect and log in to your Perdoo account.
You'll see 'Connected' once successful.

Gemini

Connecting Perdoo to Gemini requires adding Perdoo’s MCP server configuration to an MCP-compatible Gemini client, such as Gemini CLI.

Go to Personal settings > API tokens to create an API key.
- Copy the token immediately and store it securely since it will not be displayed again
Connector details:
- Name: Perdoo
- MCP Server URL: https://mcp.perdoo.com
Configure Gemini CLI
- Add the server to your Gemini CLI configuration file (located at ~/.gemini/settings.json globally or .gemini/settings.json in your project directory):

{
  "mcpServers": {
    "perdoo": {
      "httpUrl": "https://mcp.perdoo.com/",
      "headers": {
        "Authorization": "Bearer YOUR_PERDOO_API_KEY"
      }
    }
  }
}

gemini mcp add --transport http \
  --header "Authorization: Bearer YOUR_PERDOO_API_KEY" \
  perdoo https://mcp.perdoo.com/

Verify the Connection
- Run gemini mcp list in your terminal, or launch a session by running gemini and type /mcp.
- Confirm Gemini has discovered Perdoo’s tools (such as list_okrs, get_result, or update_goal_progress).

Gemini handles function calling behind the scenes, triggering the Perdoo MCP server and returning structured status updates.

Perplexity

Go to https://www.perplexity.ai/account/connectors
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 a success message.

Available tools

The MCP server acts as you, so your AI tool can only see and change what your Perdoo account is allowed to. Read-only tools only fetch data. Write and delete tools make changes in Perdoo.

Read-only tools

Tool	Description
get_company	Get your company's settings, such as name, timezone, framework, whether KPIs and Strategic Pillars are enabled, and the check-in frequency
get_kpi	Get a single KPI by ID, including lead, owning teams, tags, targets, and custom field values
get_latest_review	Shows your last review, whether one is due, which periods you can file for, and your company's reflections template
get_latest_team_review	Shows a team's last review, who filed it, which periods are open, and the team reflections template
get_me	Get your own user ID, name, and active status
get_meeting	Get a meeting in full, including its series, organizer, participants, talking points, tasks, and notes
get_objective	Get a single Objective by ID, including Key Results, lead, timeframe, tags, update frequency, and custom field values
get_result	Get a single Key Result or Initiative by ID, including its parent Objective, lead, tags, targets, and custom field values
get_strategic_pillar	Get a single Strategic Pillar by ID, including children, lead, timeframe, tags, and progress details
get_team	Get a single team by ID, including its mission, lead, members, sub-teams, and parent teams
list_explore_folders	List the Explore folders in your company
list_explore_views	List the saved Explore views you can open, including their type, folder, sharing status, and filters
list_kpis	List KPIs (Key Performance Indicators) with optional filters
list_meeting_series	List the meeting series you organize or take part in, such as recurring 1:1s and team syncs
list_meetings	List individual meetings in a series, filtered by series, date range, or upcoming
list_objectives	List Objectives with optional filters, including progress, status, stage, lead, timeframe, and owning teams
list_okrs	List OKRs (Objectives together with their Key Results)
list_results	List Key Results and Initiatives
list_reviews	List submitted Reviews and Team Reviews, including reflections and Pulse ratings
list_strategic_pillars	List Strategic Pillars with optional filters
list_tags	List company tags with ID, name, description, and color
list_tasks	List tasks, such as your open tasks from the "My tasks" tab on Home, or all tasks in a meeting
list_teams	List teams with optional filters, including their mission, lead, and archived status
list_timeframes	List timeframes (planning periods) with their start and end dates
list_updates	List progress updates (value changes on goals)
list_users	List users with optional filters
search_all	Search users, teams, and goals by name (users also by email)

Some read-only tools accept extra options that return more detail about a goal:

includeNotes (on get_kpi, get_objective and get_result): adds the goal's notes (activity-feed comments).
includeProgressHistory (on get_kpi and get_result): adds the goal's progress update history.
includeTargets (on get_kpi and get_result): adds the goal's per-period target rows.

Write and delete tools

Tool	Description
add_goal_target	Add a target to a KPI, Key Result, or Initiative, with its own period and value. It adds one target per call, so a monthly target that increases every month takes one call per month. Binary and milestone goals have fixed targets.
archive_goals	Archive Objectives, Key Results, Initiatives, KPIs, or Strategic Pillars. Archived goals keep their history, and archiving an Objective also archives its Key Results and Initiatives. Your AI tool asks you to confirm first. To restore an Objective, Key Result, Initiative, or KPI, set it back to Active with update_goals.
create_kpi	Create a KPI with a lead, target type, and start and end values
create_objective	Create an Objective in a timeframe (Active by default; pass stage DRAFT to review it in Perdoo first)
create_result	Create a Key Result or Initiative under an Objective
create_strategic_pillar	Create a Strategic Pillar owned by one or more teams, or by the whole company
create_tag	Create a company tag (admins only)
delete_goals	Permanently delete Objectives, Key Results, Initiatives, KPIs, or Strategic Pillars. This can't be undone. Deleting an Objective also deletes its Key Results and Initiatives. Your AI tool asks you to confirm first.
draft_okrs	Create a draft Objective and its Key Results in one call, so a full OKR can be drafted in conversation and reviewed in Perdoo before going live
remove_goal_target	Remove a target from a KPI, Key Result, or Initiative
submit_review	File your own review, including your Pulse rating (if enabled), for the period you pick
submit_team_review	File a review on behalf of a team (team members and admins)
update_goal_progress	Log a progress update (new value, status, and note) on a KPI, Key Result, or Initiative
update_goals	Edit an existing Objective, Key Result, Initiative, or KPI: rename it, change its lead, adjust targets, change its alignment, add tags, or change its stage (for example, publish a draft or close it)
update_strategic_pillar	Change a pillar's name, description, owning teams, tags, or the pillar it sits under
upsert_explore_folder	Create or rename an Explore folder (superadmins only)
upsert_explore_view	Create or update a saved Explore view, including goal filters and KPI board configuration
upsert_meeting_item	Add or edit a talking point on a meeting agenda
upsert_meeting_note	Add or edit a meeting note
upsert_task	Add, edit, complete, or reopen a task, either personal or in a meeting
upsert_team	Create or update a team