Step 1: Add Composio to Claude (one-time process)
- Click the button below. This will take you to the Claude Custom Connector modal.
Add to Claude
- Click Continue
- In the next modal, click Add
- It will take you to the authentication page. Sign in to Composio and approve the connection.
Then return to Claude and make sure Composio is enabled.
Step 2: Connect your first Linear account
In a new Claude chat, type:
Connect my linear-1 Linear account to Composio. Call it linear-1.
Claude will give you a sign-in link.
- Click the link.
- Sign in to your linear-1 Linear account.
- Review and approve Linear's permission request.
- Return to Claude.
Claude should confirm that the account is connected.
The name linear-1 is how Claude knows which Linear account to use. Choose short, obvious names. Good examples include:
linear-1
linear-2
linear-3
Step 3: Connect your second Linear account
In the same Claude chat, type:
Connect another Linear account. Call it linear-2.
Claude will give you a new sign-in link.
- Open the link.
- Sign in to the second Linear account.
- Review and approve Linear's permission request.
- Return to Claude.
Claude should confirm that linear-2 is connected.
Important: Check that Linear is showing the second account before you approve access. If the wrong account appears, sign out or open the link in an incognito or private window.
Repeat this step for every other Linear account you want to add. Give each connection a short, descriptive name such as linear-1, linear-2, linear-3, or client-acme.
Step 4: Check your connected Linear accounts
Ask Claude:
List my connected Linear accounts in Composio. Show each account's name and connection status.
You should see every account you added, and each connection should show as ACTIVE.
For an extra check, ask:
Show the account email or ID and the account name for each connected Linear account.
This helps you confirm that every label points to the correct Linear account and that you did not connect the same account twice.
Step 5: Use the right Linear account
Mention the account name whenever you ask Claude to work with Linear. This is especially important when an action could change data.
Review activity across accounts
Check linear-1 and linear-2 for anything new in Linear from the last 14 days. Group the results by account.
Add a comment to issue LIN-123
Using the linear-1 account, add a comment to issue LIN-123.
List all cycles for the Design team
Using the linear-2 account, list all cycles for the Design team.
Find something across accounts
Search all connected Linear accounts for customer@example.com. Show which account it appears in and summarise the latest activity.
For actions such as creating, changing, or deleting data, ask Claude to show you the planned action first and wait for your confirmation.