Skip to main content

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!
Setup for Claude Code
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.

Setup for Claude Desktop

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.

Setup for Cursor

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.

Setup for VS Code

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.

Setup for Codex CLI

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

Tool Description
list_organizations List all organizations
get_current_organization Get current organization
set_organization Set active organization

Users

Tool Description
list_users List users, filter by name or email
get_user Get a user by ID, name, or email

Collections (Folders)

Tool Description
list_collections List all collections (folders)

Boards

Tool Description
list_boards List boards
get_board Get board with columns
get_current_board Get current board
set_board Set active board

Cards

Tool Description
list_cards List cards on board
get_card_details Get card details
add_comment Add a comment to card
create_card Create a card
update_card Update a card
move_card Move card to column or another board, or reorder it in a column
assign_card Assign/unassign user
tag_card Add/remove tag
delete_card Delete a card
list_custom_fields List custom fields

Tags

Tool Description
list_tags List tags, filter by name

Columns

Tool Description
list_columns List columns on board
create_column Create a column
rename_column Rename a column
move_column Move column position
delete_column Delete a column

Lanes (Swimlanes)

Tool Description
list_lanes List lanes (swimlanes) on board

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"
      }
    }
  }
}
  • lh-etals/favro-mcp — a Go rewrite of this project with a single-binary installer, wider tool coverage, and multi-client auto-configuration.

Metadata

Release files for favro-mcp 0.8.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for favro-mcp 0.8.0
File Size Uploaded Provenance Actions
favro_mcp-0.8.0.tar.gz 26.1 kB With provenance Details for favro_mcp-0.8.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for favro-mcp 0.8.0
File Interpreter ABI Platform Actions
favro_mcp-0.8.0-py3-none-any.whl Python 3 none any Details for favro_mcp-0.8.0-py3-none-any.whl

Total release size: 62.0 kB

Release files / favro_mcp-0.8.0.tar.gz

Download URL favro_mcp-0.8.0.tar.gz
Size 26.1 kB
Tags Source
SHA-256 checksum
How to use checksums
b5b29bdb8fcb749b3434b380f37689bb4fe9ea72e6dffd675a79bcc97b412aef
BLAKE2b-256 checksum
How to use checksums
f1ea652ed856f39d844cc14589dea11a0ed9b78c97c53ac2a1217d8ec9bc9d51
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 2, 2026.

Transparency log

Release files / favro_mcp-0.8.0-py3-none-any.whl

Download URL favro_mcp-0.8.0-py3-none-any.whl
Size 35.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
f7c581cfefbb23bd7d75e727e04b8b9e5c700b30d41846f51a6c410718c39c7a
BLAKE2b-256 checksum
How to use checksums
6e7db14d7a6f4aa3216804052861bb5dd42081d8dbafb5209ec6f629e1a0ea25
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 2, 2026.

Transparency log

Security for favro-mcp 0.8.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

All 2 files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for favro_mcp-0.8.0.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 2, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page