Connect ChatGPT and Claude to your OKRs (MCP server guide)
How to let ChatGPT, Claude, Claude Code, Cursor or VS Code read your OKRs, post check-ins and flag at-risk key results through PieDash's MCP server — setup in two minutes.
By Ammar Tosun
What an MCP server does for OKRs
The Model Context Protocol (MCP) is the open standard AI assistants use to work with other software. With an MCP server, an assistant such as ChatGPT or Claude can read your objectives and key results, post check-ins and draft changes — in the same chat where you plan your week, with your permissions and nothing more.
What PieDash's MCP server can do
The server at https://piedash.com/mcp has 25 tools:
- Read: sessions, objectives, key results and tasks; check-in history; a workspace summary; search.
- Attention:
list_at_risk_key_resultsreturns key results that are behind pace, have low confidence or no recent check-in — each with its reasons. - Write: create and update objectives, key results and tasks; post check-ins; comment.
- Propose:
create_suggestionqueues a change that a person approves or rejects in PieDash — nothing changes on its own.
Three prompts are built in: an OKR review, a weekly update and coaching for one objective. Every tool carries read-only or destructive hints, so assistants ask before they change things.
Connect Claude
- In Claude, open Settings → Connectors → Add custom connector.
- Enter
https://piedash.com/mcpas the server URL. - Open Advanced settings and set the OAuth Client ID to
piedash-mcp(leave the secret empty). - Sign in with your PieDash account and approve access.
Connect ChatGPT
- Turn on developer mode in ChatGPT (Settings → Apps → Advanced settings).
- Create an app with the server URL
https://piedash.com/mcp. - Choose OAuth and enter the client ID
piedash-mcp(no secret). - Sign in with your PieDash account and approve access.
Claude Code, Cursor, VS Code and your own agents
Clients that support OAuth use the same client ID. Headless agents and scripts use an API key instead: create one under Settings → API & MCP with read, write or admin scope and an optional expiry. The in-app Agent guide shows ready-to-paste configurations for Claude Code, Claude Desktop, Cursor, Windsurf and VS Code with your workspace ID filled in. The full reference is the agent guide.
Prompts to try
- "Which key results are behind pace this quarter, and who owns them?"
- "Post a check-in on 'Reduce churn to 3%': 3.8%, confidence 6, note: pricing test starts Monday."
- "Draft three key results for our onboarding objective and propose them for approval."
- "Write this week's OKR update for the marketing team."
Security
With OAuth, the assistant acts as the person who signed in, in that person's workspace, with that person's role — a viewer's assistant cannot edit. Access needs explicit consent and can be revoked at any time. API keys have scopes and expiry dates and can be revoked in Settings. Customer data stays in PieDash's EU hosting; what the assistant does with the answers is governed by your AI provider's terms.
Frequently asked
Does the MCP server cost extra?
No. It is part of every PieDash plan, including the free plan for up to 5 people.
Can the AI change my OKRs without me?
Only when you ask it to and your role allows it. The create_suggestion tool queues proposals that a person approves or rejects in PieDash.
Which assistants work with PieDash?
ChatGPT and Claude through OAuth with the client ID piedash-mcp; Claude Code, Cursor, VS Code, Windsurf and any other MCP client through OAuth or an API key.
Try PieDash
Bring these ideas to life with PieDash — AI-drafted OKRs, Slack/Teams check-ins, alignment maps. Free for up to 5 people.