Favro MCP

MCP server for interacting with Favro project management.

Installation

pip install favro-mcp

Getting Your Favro API Token

1. Log in to Favro
2. Click your username (top-left corner)
3. Select My Profile
4. Go to API Tokens
5. Click Create new token
6. Give it a name (e.g., "Favro MCP") and click Create
7. Copy the token — you won't be able to see it again!

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

See Claude Code MCP documentation for more details.

Add the following to your claude_desktop_config.json (~/Library/Application Support/Claude/ on macOS, %APPDATA%\Claude on Windows):

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

Finding the full path: Claude Desktop doesn't inherit your shell's PATH, so you need the absolute path to favro-mcp:

# macOS/Linux (with pip)
which favro-mcp

# Windows (PowerShell)
(Get-Command favro-mcp).Source

Then restart Claude Desktop.

See Claude Desktop MCP documentation for more details.

Add the following to your Cursor MCP configuration file:

• Global (all projects): ~/.cursor/mcp.json
• Project-specific: .cursor/mcp.json in your project root

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

You can also open the MCP settings via Command Palette: Cmd+Shift+P (Mac) or Ctrl+Shift+P (Windows) → search "MCP" → select "View: Open MCP Settings".

After configuration, use Agent mode in Cursor's AI chat to access Favro tools.

See Cursor MCP documentation for more details.

Add the following to .vscode/mcp.json in your workspace:

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

Use Agent mode in GitHub Copilot Chat to access Favro tools.

See VS Code MCP documentation for more details.

Add the following to ~/.codex/config.toml:

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

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

Or add via CLI:

codex mcp add favro \
  --env FAVRO_EMAIL=your-email@example.com \
  --env FAVRO_API_TOKEN=your-token \
  -- favro-mcp

See Codex MCP documentation for more details.

Tools

Organizations

Users

Collections (Folders)

Boards

Cards

Tags

Columns

Lanes (Swimlanes)

Lanes themselves are read-only in the Favro API (no create/rename/delete). To place a card in a lane, pass its ID or name as the lane argument to create_card, update_card, or move_card (use list_lanes to discover them).

Development

This project uses uv for development.

Setup

1. Install uv:

   macOS / Linux:

   curl -LsSf https://astral.sh/uv/install.sh | sh
   

   Windows (PowerShell):

   powershell -c "irm https://astral.sh/uv/install.ps1 | iex"
   

2. Clone the repository:

   git clone https://github.com/truls27a/favro-mcp.git
   cd favro-mcp
   

3. Install dependencies:

   uv sync --dev
   

Running from Source

To run a local/modified version instead of the published package:

{
  "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"
      }
    }
  }
}

Related

• lh-etals/favro-mcp — a Go rewrite of this project with a single-binary installer, wider tool coverage, and multi-client auto-configuration.