# MCP integration

The **MCP** integration lets AI assistants such as Claude, ChatGPT and Cursor work in Favro for you. Ask your assistant in plain words to find a card, write a comment or set up a board, and it does it in Favro. Your assistant works as you: it can only see and do what you can in Favro, and only what you allow when you connect.

## Turn on the integration

The integration is on by default for new organizations. If it is off in yours:

1. Open the app menu and select **Administration**.
2. Go to **Apps and integrations**.
3. Find **MCP** and turn it on.

## Connect Claude

1. In Claude, open **Customize** in the sidebar and select **Connectors**.
2. Select **Add**, then **Add custom connector**.
3. Enter **Favro** as the name and `https://favro.com/mcp` as the URL, then select **Continue**.
4. Keep the detected options, **Sign in now** and **Use Claude's published identity**, and select **Add**.
5. Select **Connect** and sign in to Favro in the window that opens.

The same steps apply in Claude Desktop, including Claude Code in it.

Claude Code in the terminal: run `claude mcp add --transport http favro https://favro.com/mcp`, then run `/mcp` and choose **Authenticate**.

## Connect ChatGPT

Favro is coming to the ChatGPT app directory. Until then, ChatGPT can connect to Favro as a custom app in developer mode, with the address `https://favro.com/mcp`. See OpenAI's guide: [Developer mode and MCP apps in ChatGPT](https://help.openai.com/en/articles/12584461-developer-mode-apps-and-full-mcp-client-support-in-chatgpt).

## Connect Codex

1. In Codex, open **Settings** and select **Plugins**.
2. Select **Add**, then **Add MCP server**.
3. Enter **Favro** as the name, choose **Streamable HTTP**, enter `https://favro.com/mcp` as the URL and select **Save**.
4. Select **Authenticate** next to **favro** and sign in to Favro.

Codex in the terminal: run `codex mcp add favro --url https://favro.com/mcp`, then `codex mcp login favro`.

## Connect Cursor

Cursor signs in with a Favro API token.

1. In Favro, open **My profile**, select **API Tokens** and create a token. Copy it.
2. Turn your email address and the token into one encoded value. In a terminal, run:

   ```
   printf '%s' 'you@example.com:your-api-token' | base64
   ```

3. In Cursor, open **Cursor Settings**, select **Customize** in the sidebar, then **MCPs**, and select **New MCP Server**.
4. Add this to the file that opens, with the encoded value in place of the placeholder, and save:

   ```json
   {
     "mcpServers": {
       "favro": {
         "url": "https://favro.com/mcp",
         "headers": {
           "Authorization": "Basic PASTE_THE_ENCODED_VALUE_HERE"
         }
       }
     }
   }
   ```

Favro is then listed under **MCPs** with its tools.

## Connect other assistants

Any assistant that supports MCP can connect. Add a remote MCP server with this address and sign in to Favro when asked:

```
https://favro.com/mcp
```

If your assistant cannot sign in with an account, use a Favro API token instead, as described for Cursor above.

## What your assistant can do

When you connect, Favro asks what your assistant may do:

* **Read Favro data**: see your cards, boards, collections, comments and members.
* **Search Favro data**: search your cards.
* **Write Favro data**: create, change and delete cards, boards and collections.

To change your choice later, disconnect Favro in your assistant and connect again.

In Cursor, a **Read only** API token lets your assistant read and search only. A normal token lets it do everything.

## Supported tools

These are the tools your assistant can use. They may change over time as the integration grows.

### Read tools

These tools only look at your data and never change it.

| Tool | What it does |
| --- | --- |
| `get_card` | Gets a card with its details |
| `get_cards` | Lists the cards on a board, in a column or in a collection |
| `get_my_cards` | Lists the cards on your to-do list |
| `get_card_activity` | Lists what happened to a card |
| `get_board` | Gets a board with its columns |
| `get_boards` | Lists boards |
| `get_collection` | Gets a collection |
| `get_collections` | Lists collections |
| `get_comments` | Lists the comments on a card |
| `get_user` | Gets a member of your organization |
| `get_users` | Lists the members of your organization |
| `get_groups` | Lists the user groups of your organization |
| `get_custom_fields` | Lists the custom fields of your organization |
| `get_custom_field` | Gets a custom field |

### Search tools

Searching needs the **Search Favro data** permission.

| Tool | What it does |
| --- | --- |
| `search_cards` | Searches cards by text |

### Write tools

These tools create, change or delete data. They need the **Write Favro data** permission.

| Tool | What it does |
| --- | --- |
| `create_card` | Creates a card |
| `update_card` | Changes a card |
| `add_card_to_board` | Puts a card on another board as well |
| `move_card` | Moves a card to another board |
| `remove_card_from_board` | Takes a card off a board |
| `delete_card` | Deletes a card |
| `add_comment` | Adds a comment to a card |
| `add_attachment` | Attaches a file to a card or a comment |
| `create_board` | Creates a board |
| `update_board` | Changes a board |
| `create_collection` | Creates a collection |
| `update_collection` | Changes a collection |