Metadata-Version: 2.4
Name: favro-mcp
Version: 0.1.0
Summary: MCP server for Favro project management
Author-email: Truls Borgvall <truls.borgvall@icloud.com>
License-Expression: MIT
License-File: LICENSE
Requires-Python: >=3.12
Requires-Dist: fastmcp>=2.0.0
Requires-Dist: httpx>=0.27.0
Requires-Dist: pydantic>=2.0
Requires-Dist: python-dotenv>=1.0.0
Provides-Extra: dev
Requires-Dist: pyright>=1.1.389; extra == 'dev'
Requires-Dist: pytest-asyncio>=0.24; extra == 'dev'
Requires-Dist: pytest>=8.0; extra == 'dev'
Description-Content-Type: text/markdown

# Favro MCP

MCP server for interacting with Favro.

## Installation

```bash
git clone https://github.com/truls27a/favro-mcp.git
cd favro-mcp
python -m venv .venv
source .venv/bin/activate  # or .venv\Scripts\activate on Windows
pip install -e .
```

Create a Favro API token at **Favro → My Profile → API Tokens**.

## Setup

Add to your MCP client config (replace with your credentials):

```json
{
  "mcpServers": {
    "favro": {
      "command": "/path/to/favro-mcp/.venv/bin/favro-mcp",
      "env": {
        "FAVRO_EMAIL": "your-email@example.com",
        "FAVRO_API_TOKEN": "your-token"
      }
    }
  }
}
```

### Claude Code

```bash
claude mcp add --transport stdio favro \
  -e FAVRO_EMAIL=your-email@example.com \
  -e FAVRO_API_TOKEN=your-token \
  -- /path/to/favro-mcp/.venv/bin/favro-mcp
```

## Resources

| Resource                         | Description              |
| -------------------------------- | ------------------------ |
| `favro://organizations`          | List all organizations   |
| `favro://organization/current`   | Get current organization |
| `favro://boards`                 | List all boards          |
| `favro://boards/{board_id}`      | Get board with columns   |
| `favro://board/current`          | Get current board        |
| `favro://boards/{board_id}/cards`   | List cards on board   |
| `favro://boards/{board_id}/columns` | List columns on board |
| `favro://cards/{card_id}`        | Get card details         |

## Tools

| Tool               | Description            |
| ------------------ | ---------------------- |
| `set_organization` | Set active organization |
| `set_board`        | Set active board       |
| `create_card`      | Create a card          |
| `update_card`      | Update a card          |
| `move_card`        | Move card to column    |
| `assign_card`      | Assign/unassign user   |
| `tag_card`         | Add/remove tag         |
| `delete_card`      | Delete a card          |
| `create_column`    | Create a column        |
| `rename_column`    | Rename a column        |
| `move_column`      | Move column position   |
| `delete_column`    | Delete a column        |
