> ## Documentation Index
> Fetch the complete documentation index at: https://docs.forecastable.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Cursor integration

> Add Forecastable to Cursor with an MCP JSON configuration and OAuth sign-in.

Give Cursor access to your Forecastable accounts, contacts, and plans through the [MCP server](/developers/mcp). You need Cursor and a Forecastable account.

Start on [Settings → Integrations](https://app.forecastable.com/settings/integrations) and select **Set up** on the **Cursor** card under **Agents**.

<Frame caption="Agent setup links in Forecastable">
  <img src="https://mintcdn.com/forecastable/ist8Jy2yvlYGqFBe/images/integrations/agents/cards.png?fit=max&auto=format&n=ist8Jy2yvlYGqFBe&q=85&s=88ea0bb5e262b45006286e12e54ccd49" alt="Forecastable Agents section with a Cursor setup card alongside ChatGPT and Claude" width="1280" height="720" data-path="images/integrations/agents/cards.png" />
</Frame>

## Add the JSON configuration

<Steps>
  <Step title="Open your MCP configuration">
    For one project, open or create `.cursor/mcp.json` in the project folder. For all projects, use `~/.cursor/mcp.json` in your home directory (on Windows, `%USERPROFILE%\.cursor\mcp.json`).
  </Step>

  <Step title="Add Forecastable">
    Paste this configuration and save the file. If you already have MCP servers, add only the `forecastable` entry inside your existing `mcpServers` object.

    ```json theme={null}
    {
      "mcpServers": {
        "forecastable": {
          "url": "https://app.forecastable.com/mcp"
        }
      }
    }
    ```
  </Step>

  <Step title="Sign in">
    Find Forecastable in Cursor’s MCP server controls and start its login flow. Cursor discovers Forecastable’s OAuth settings and registers the client automatically. Sign in to Forecastable in the browser, review the requested access, and select **Allow**.
  </Step>

  <Step title="Verify the tools">
    Confirm Forecastable is enabled and its tools are available. In Cursor Agent, ask: “Use Forecastable to list my organizations. Ask me which organization to use, then list five accounts from it.” Review tool requests when Cursor prompts you.
  </Step>
</Steps>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Forecastable does not appear">
    Check that the file is named `mcp.json`, that the JSON is valid, and that `forecastable` is
    inside `mcpServers`. Reopen Cursor after saving if it has not picked up the change. Your
    organization may restrict which MCP servers you can use.
  </Accordion>

  <Accordion title="Cursor reports missing organization context">
    Single-organization users receive an automatic default. If an organization is missing, the
    error lists accessible names and IDs; retry with `params.organizationId`. With multiple
    organizations, use `setActiveOrganization` to save your choice across reconnects and new chats
    on the same token.
  </Accordion>

  <Accordion title="Sign-in fails">
    Confirm the URL is `https://app.forecastable.com/mcp` and retry the login flow. If you need a
    static token instead, follow the [API key connection example](/developers/mcp#connect-manually).
  </Accordion>
</AccordionGroup>

## Disconnect

Disable Forecastable in Cursor or remove its entry from `mcpServers` to stop loading its tools.

See Cursor’s [MCP documentation](https://prod.cursor.com/docs/mcp) for current configuration and client controls.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.