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

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
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 all tags

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

Related

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

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Latest release

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for truls27a from gravatar.com truls27a

Credits

Author: Truls Borgvall

License expression

MIT
View SPDX License List

Requires

Python >=3.12

Provides Extra

dev

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

favro_mcp-0.7.2.tar.gz (24.2 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

favro_mcp-0.7.2-py3-none-any.whl (33.9 kB view details)

Uploaded Python 3

File details

Details for the file favro_mcp-0.7.2.tar.gz.

File metadata

  • Download URL: favro_mcp-0.7.2.tar.gz
  • Upload date:
  • Size: 24.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for favro_mcp-0.7.2.tar.gz
Algorithm Hash digest
SHA256 cc3ad3be060c46347201e26c2c1295137a83a5491425d8f2d30b6f571ec3a6e4
MD5 bf9e28c064c28df2b21caeb75c024fcd
BLAKE2b-256 4c665d7b3a1d16ce4668a72130abf5e994a0463b77cdd0f92a415063866a6e78

See more details on using hashes here.

Provenance

The following attestation bundles were made for favro_mcp-0.7.2.tar.gz:

Publisher: publish.yml on truls27a/favro-mcp

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file favro_mcp-0.7.2-py3-none-any.whl.

File metadata

  • Download URL: favro_mcp-0.7.2-py3-none-any.whl
  • Upload date:
  • Size: 33.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for favro_mcp-0.7.2-py3-none-any.whl
Algorithm Hash digest
SHA256 cbedf586a9605965fe0f9019a0f6fa0c1a87d67f5e431a0b68cb9f9d668073ee
MD5 9a8aa0cbb76e13be6b0b910291d4b82c
BLAKE2b-256 55bbd00be0663a1a7808c08a39e331b91dd992dc733c72362a30b68173ec0f9c

See more details on using hashes here.

Provenance

The following attestation bundles were made for favro_mcp-0.7.2-py3-none-any.whl:

Publisher: publish.yml on truls27a/favro-mcp

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

This release

0.7.2 This release

2 files

0.7.1

2 files

0.7.0

2 files

0.6.1

2 files

0.6.0

2 files

0.5.2

2 files

0.5.1

2 files

0.5.0

2 files

0.4.0

2 files

0.3.2

2 files

0.3.1

2 files

0.3.0

2 files

0.2.1

2 files

0.2.0

2 files

0.1.0

2 files

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