Sign inOpen the board

Use Klio with Cursor

Add Klio to Cursor's MCP servers. The agent in Cursor reads the board, builds stories by ID and keeps your resume note current.

!Before you start: create a token in Klio under Settings → Connect agents, and use it in place of klio_YOUR_TOKEN.

  1. Add Klio to mcp.json

    Use ~/.cursor/mcp.json for every project, or .cursor/mcp.json in one repo. Cursor reads ${env:KLIO_TOKEN} from your environment, so the token stays out of the file.

    ~/.cursor/mcp.json
    {
  "mcpServers": {
    "klio": {
      "url": "https://klio.dev/api/mcp",
      "headers": {
        "Authorization": "Bearer ${env:KLIO_TOKEN}"
      }
    }
  }
}

  2. Turn it on

    Open Cursor Settings → MCP (Tools & Integrations). Klio appears with a green dot once it connects. Toggle it on if it isn't.

  3. Check it works

    In the agent chat, ask: “call klio whoami”.

iIf Cursor can't see KLIO_TOKEN, launch it from a terminal that has it set, or paste the token in place of the variable.

Then paste the setup prompt

With Cursor connected, this puts the repo on your board and starts building with you. Replace the highlighted part.

The setup prompt
Use Klio (klio.dev) as the project board for this repo. It's connected over MCP as "klio".

1. Call whoami to check the connection. If it fails, stop and tell me what to fix.
2. Find this repo's project with list_projects. If there isn't one, create it with create_project: name it after the repo and pick a short key.
3. Record what's already here: call sync_stack with package.json (and any other manifests), add features that already work as done stories, and half-finished work as stories in progress.
4. What I'm building next: <describe it in a sentence or two>
   Call brief_feature, write small stories with acceptance criteria, show me the plan, and save it with create_feature once I approve.
5. Build it one story at a time: start_issue before you write code, check_criterion as each criterion really passes, complete_issue with a short summary once it's tested. Don't start a second story while one is in progress, and leave Done to me.
6. Before you stop, hand me anything only I can do (secrets, DNS, billing) with flag_for_human.

Other agents

Claude CodeTerminal agentCodexTerminal agentWindsurfEditorVS Code + GitHub CopilotEditorZedEditorKiroEditorClineVS Code extensionGemini CLITerminal agentopencodeTerminal agentAny MCP clientGeneric
PreviousCodexNextWindsurf

Endpoint: https://klio.dev/api/mcp. Menus and file paths can move between Cursor releases; if a step looks different, the server URL and header are what matter.