truls27a/favro-mcp

5 stars 8 forks Quality 85 Trend 21MIT

MCP server for interacting with Favro project management.

Overview

MCP server for interacting with Favro project management. 1. Log in to Favro 2. Click your (top-left corner) 3. Select 4. Go to 5. Click 6. Give it a name (e.g., "Favro MCP") and click 7. — you won't be able to see it again! 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): Claude Desktop doesn't inherit your shell's PATH, so you need the absolute path to favro-mcp: See Claude Desktop MCP documentation for more details. Add the following to your Cursor MCP configuration file: - ~/.cursor/mcp.json - .cursor/mcp.json in your project root

README

Favro MCP

MCP server for interacting with Favro project management.

Installation

pip install favro-mcp

Getting Your Favro API Token

Log in to Favro
Click your username (top-left corner)
Select My Profile
Go to API Tokens
Click Create new token
Give it a name (e.g., “Favro MCP”) and click Create
Copy the token — you won’t be able to see it again!

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

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

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"

Clone the repository:

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

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": "[email protected]",
        "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.

View the full README on GitHub

Install

This server does not publish a one-line install command.

Open the repository installation guide New to MCP? Start with the mcpskill.org guide →

Configuration

{
  "mcpServers": {
    "favro": {
      "command": "/full/path/to/favro-mcp",
      "env": {
        "FAVRO_EMAIL": "[email protected]",
        "FAVRO_API_TOKEN": "your-token-here"
      }
    }
  }
}