Plot HomeDocumentation

Use Plot in Cursor

Add the Plot MCP server to Cursor so its agent can read tasks, update status, and leave progress comments in Plot.

Connect Plot to Cursor so its agent works from your real tasks. The agent can read a task before it starts, update its status, leave progress comments, and save plans as Plot documents.

Before you start

You need:

  • Cursor installed and up to date.
  • A Plot account with access to the workspace you want to connect.

Add Plot to Cursor

  1. Open ~/.cursor/mcp.json for all projects, or .cursor/mcp.json for one project. Create the file if it doesn't exist.

  2. Add the Plot server:

    {
      "mcpServers": {
        "plot": {
          "url": "https://mcp.plot.app/mcp"
        }
      }
    }
  3. Open Cursor Settings > Tools & MCP.

  4. Select Connect next to Plot.

  5. In the Plot window, sign in, choose your workspace, and select Authorize.

What Cursor can do in Plot

Once connected, Cursor's agent can:

  • Read a task, its comments, and its project before it starts work.
  • Update task status, assignees, labels, and dependencies.
  • Create task trees for a plan, with subtasks and dependencies.
  • Leave comments with progress, blockers, and handoff notes.
  • Create documents for plans, briefs, and decisions.

Example prompts

CategoryExample prompts
Start from PlotRead ENG-42 and its comments, then plan the change.
Report progressMove ENG-42 to In review and comment with what changed and how you tested it.
Find contextSearch Plot for past decisions about the checkout flow.

Disconnect Plot

Remove the plot entry from your mcp.json file, or turn Plot off in Cursor Settings > Tools & MCP.

Troubleshoot

Plot shows "Needs authentication"

Select Connect next to Plot in Cursor Settings > Tools & MCP and sign in again. This also happens when a connection reaches its 30-day limit.

The sign-in page doesn't return to Cursor

Make sure your browser allows Cursor to open links, then select Connect again.

For other issues, see Troubleshoot common issues.