Favro

Favro MCP is a server you run locally to interact with Favro project management data via a modular client interface. It exposes a set of tools to work with organizations, collections, boards, cards, and more, letting you automate tasks and integrate Favro into your workflows.

How to use

You use Favro MCP by running a local MCP server and connecting your Favro-enabled client (Claude, Cursor, VS Code, Codex CLI, or a development workflow) to it. Once connected, you can list organizations and collections, inspect boards and cards, add comments, create or move items, manage columns, and apply tags or assignments. The server uses your Favro API token for authentication, so keep your token secure and only supply it to trusted tools.

To start using Favro MCP with a supported client, select one of the following setup paths and follow the exact commands shown. For best results, use a dedicated API token and avoid sharing it.

How to install

Prerequisites you need before installation: Python and pip installed on your system. You may also install and use a development tool like uv if you plan to run the MCP server from source.

Install Favro MCP from PyPI using pip. Run the command below in your terminal.

pip install favro-mcp

Additional setup options

Choose a client setup to run Favro MCP locally. Each option shows the exact command and required environment variables.

Claude Code setup

claude mcp add --transport stdio favro \
  -e FAVRO_EMAIL=your-email@example.com \
  -e FAVRO_API_TOKEN=your-token \
  -- favro-mcp

Claude Desktop setup

Place the absolute path to the Favro MCP executable and configure environment variables in Claude Desktop.

{
  "mcpServers": {
    "favro": {
      "command": "/full/path/to/favro-mcp",
      "env": {
        "FAVRO_EMAIL": "your-email@example.com",
        "FAVRO_API_TOKEN": "your-token-here"
      }
    }
  }
}

Cursor setup

Configure Cursor to load Favro MCP for all projects or per project.

{
  "mcpServers": {
    "favro": {
      "command": "favro-mcp",
      "env": {
        "FAVRO_EMAIL": "your-email@example.com",
        "FAVRO_API_TOKEN": "your-token-here"
      }
    }
  }
}

VS Code setup

Add an MCP configuration file in your workspace to connect to Favro MCP.

{
  "servers": {
    "favro": {
      "type": "stdio",
      "command": "favro-mcp",
      "env": {
        "FAVRO_EMAIL": "your-email@example.com",
        "FAVRO_API_TOKEN": "your-token-here"
      }
    }
  }
}

Codex CLI setup

Configure Codex to connect to Favro MCP using the Codex config file.

[mcp_servers.favro]
command = "favro-mcp"

[mcp_servers.favro.env]
FAVRO_EMAIL = "your-email@example.com"
FAVRO_API_TOKEN = "your-token-here"

Running from source

If you are developing locally, run Favro MCP via uv with the Python module.

{
  "mcpServers": {
    "favro": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "/path/to/favro-mcp",
        "python",
        "-m",
        "favro_mcp"
      ],
      "env": {
        "FAVRO_EMAIL": "your-email@example.com",
        "FAVRO_API_TOKEN": "your-token-here"
      }
    }
  }
}

Available tools

list_organizations

List all organizations the authenticated user has access to.

get_current_organization

Retrieve the currently active Favro organization.

set_organization

Set the active Favro organization for subsequent operations.

list_collections

List all collections (folders) within the active context.

list_boards

List boards available in the current context or organization.

get_board

Get details of a specific board including its columns.

get_current_board

Retrieve the currently active board.

set_board

Set the active board for subsequent operations.

list_cards

List all cards on the current board.

get_card_details

Fetch full details of a specific card.

add_comment

Add a comment to a card.

create_card

Create a new card on a board.

update_card

Update properties of an existing card.

move_card

Move a card to a different column.

assign_card

Assign or unassign a user on a card.

tag_card

Add or remove tags on a card.

delete_card

Delete a card.

list_custom_fields

List custom fields available on cards.

list_columns

List columns on the current board.

create_column

Create a new column on the current board.

rename_column

Rename an existing column.

move_column

Move a column to a new position.

delete_column

Delete a column from the board.