OKR Studio MCP Server

New

The OKR Studio MCP (Model Context Protocol) server gives AI assistants direct access to your OKR data. Connect Claude Desktop, ChatGPT, GitHub Copilot, Cursor, or any MCP-compatible tool to ask plain-language questions about objectives, progress, blockers, and team alignment — without copy-pasting context.

Who It's For

• Product managers asking “What's at risk this cycle?”
• Ops leads pulling weekly progress summaries
• Developers checking OKR context while coding
• Anyone who uses an AI assistant daily

Supported Clients

• Claude Desktop
• ChatGPT (desktop app)
• GitHub Copilot (VS Code agent mode)
• Claude Code (terminal)
• Cursor IDE
• Any MCP-compatible client

Prerequisites

Before You Begin

• An OKR Studio Professional or Enterprise plan
• An MCP API key — generate one in Settings → API Access
• An MCP-compatible client (Claude Desktop, ChatGPT, GitHub Copilot, Cursor, or Claude Code)

Quick Start: Generate an API Key

1
Open API Access settings
Navigate to Settings → API Access
2
Generate a new key
Click “Generate API Key” and copy it immediately — it won't be shown again
3
Copy the MCP config snippet
The API Access page provides a ready-to-use config. Paste it into your client (see below).

Most teams connected in under 10 minutes

Generate a key, paste the config, and start asking questions. No server setup, no self-hosting, no configuration beyond the API key.

Client Setup

Claude Desktop

Open Claude Desktop settings and add an MCP server. Edit the config file at ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "okr-studio": {
      "type": "http",
      "url": "https://api.okrstud.io/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY_HERE"
      }
    }
  }
}

ChatGPT (Desktop App)

In ChatGPT desktop, go to Settings → MCP Servers → Add Server. Enter the following:

Name: OKR Studio

URL: https://api.okrstud.io/mcp

Authentication: Bearer token — paste your API key

GitHub Copilot (VS Code)

Create or update .vscode/mcp.json in your project:

{
  "servers": {
    "okr-studio": {
      "type": "http",
      "url": "https://api.okrstud.io/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY_HERE"
      }
    }
  }
}

Switch to Agent mode in Copilot Chat, then click the tools icon to verify “okr-studio” appears.

Cursor

Open Cursor Settings → MCP → Add Server. Use the same config as GitHub Copilot above, or add to .cursor/mcp.json:

{
  "mcpServers": {
    "okr-studio": {
      "type": "http",
      "url": "https://api.okrstud.io/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY_HERE"
      }
    }
  }
}

Claude Code (Terminal)

claude mcp add okr-studio \
  --transport http \
  --url https://api.okrstud.io/mcp \
  --header "Authorization: Bearer YOUR_API_KEY_HERE"

Verify with claude mcp list — you should see “okr-studio” with 10 tools.

Available Tools (10)

OKR Cycles
3 tools

list_cycles

List all OKR cycles for the organization

get_cycle

Get details for a specific OKR cycle

get_active_cycle

Get the currently active OKR cycle

Objectives
3 tools

get_current_objectives

List all active objectives for the current cycle

get_objective

Get full details for a specific objective

search_objectives

Search objectives by keyword, team, or status

Key Results
2 tools

list_key_results

List key results for an objective

get_key_result_progress

Get current progress, confidence, and status for a key result

Teams
2 tools

list_teams

List all teams in the organization

get_team_members

Get members of a specific team

Example Prompts

Check what's at risk

“What key results are at risk this cycle? Show me which teams own them.”

Summarize progress for a standup

“Summarize Q2 OKR progress for the Platform team. Highlight anything below 40% confidence.”

Find stale OKRs

“Which objectives have no check-ins in the last two weeks?”

Context while coding

“What are the current OKRs for the Growth team? I want to make sure this feature aligns with our quarterly goals.”

Prep a leadership review

“Give me a one-page summary of all company objectives, their completion percentage, and any blockers noted in recent check-ins.”

Plan Availability

Plan	MCP Server	API Keys
Free	—	—
Professional		Up to 10 keys
Enterprise		Unlimited keys

Security & Privacy

Read-only by default

All MCP tools are read-only. No tool can modify, create, or delete your OKRs, objectives, or key results.

Your data stays in your workspace

The MCP server returns data directly to your local AI client. OKR Studio does not store or log the questions you ask.

Keep your API key out of source control

Add MCP config files to .gitignore. Use environment variables if your client supports them.

One key per person or device

Create separate keys for each team member. Revoke individual keys instantly from Settings without affecting others.

Rotate keys regularly

Regenerate keys every few months, or immediately if a key is exposed. Revoke from Settings → API Access.

Troubleshooting

Server not appearing in VS Code

Ensure you are in Agent mode (not Chat or Edits). Reload the VS Code window after creating or modifying .vscode/mcp.json.

Authentication error (401)

Your API key may be expired, revoked, or incorrectly formatted. Generate a new key from Settings → API Access and update your config.

Tools return empty results

Make sure you have OKRs and objectives created in OKR Studio. The MCP server only returns data for your organization.

Claude Desktop not connecting

Restart Claude Desktop after editing the config file. Check the file path matches your OS (macOS vs Windows). Verify the JSON is valid.

We use cookies

MCP Server