How to connect multiple Confluence accounts to Claude

Connect two or more Confluence accounts to Claude with Composio. Give each account a name, check the connections, and tell Claude which one to use.

Confluence logoConfluence
Oauth2S2s Oauth2Api Key

Confluence is Atlassian's team collaboration and knowledge management platform. It helps your team organize, share, and update documents and project content in one secure workspace.

70 Tools23 Triggers

Introduction

Claude's built-in Confluence connector works well if you use one Confluence account. But when you connect a second account, it replaces the first.

If you manage separate Confluence accounts for different products, regions, or business units, that quickly becomes frustrating.

Composio fixes this by keeping each Confluence account separate and giving it a simple name, such as confluence-1, confluence-2, or confluence-3. Claude can then use the right Confluence account when you mention that name.

What you'll end up with

  • One Composio connector in Claude
  • Two or more Confluence accounts connected behind it
  • A clear name for each account
  • The ability to work in the right Confluence account from a single Claude chat

For example:

Search my confluence-1 and confluence-2 Confluence accounts for anything that needs my attention from the last 7 days. Tell me which account each item came from.

Using the confluence-1 account, create a project documentation page in Marketing space.

Before you start

  • A Claude account
  • A free Composio account
  • Access to each Confluence account you want to connect

If you use Claude Free, you can have one custom connector. If you already use that slot, you will need to remove the existing custom connector first.

If you use Claude Team or Enterprise, an Owner may need to add the connector for the organisation. Each member can then connect their own accounts.

Connect multiple Confluence accounts to Claude

Step 1: Add Composio to Claude (one-time process)

  1. Click the button below. This will take you to the Claude Custom Connector modal.

Add to Claude

  1. Click Continue
Claude's Add custom connector dialog with the Composio name and MCP URL filled in
  1. In the next modal, click Add
Second step of the Add custom connector dialog with the Add button
  1. It will take you to the authentication page. Sign in to Composio and approve the connection.
Composio sign-in page with Google, GitHub, and email options

Then return to Claude and make sure Composio is enabled.

Claude connectors list showing Composio as a connected custom connector

Step 2: Connect your first Confluence account

In a new Claude chat, type:

Connect my confluence-1 Confluence account to Composio. Call it confluence-1.

Claude will give you a sign-in link.

  1. Click the link.
  2. Sign in to your confluence-1 Confluence account.
  3. Review and approve Confluence's permission request.
  4. Return to Claude.

Claude should confirm that the account is connected.

The name confluence-1 is how Claude knows which Confluence account to use. Choose short, obvious names. Good examples include:

  • confluence-1
  • confluence-2
  • confluence-3

Step 3: Connect your second Confluence account

In the same Claude chat, type:

Connect another Confluence account. Call it confluence-2.

Claude will give you a new sign-in link.

  1. Open the link.
  2. Sign in to the second Confluence account.
  3. Review and approve Confluence's permission request.
  4. Return to Claude.

Claude should confirm that confluence-2 is connected.

Important: Check that Confluence 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 Confluence account you want to add. Give each connection a short, descriptive name such as confluence-1, confluence-2, confluence-3, or client-acme.

Step 4: Check your connected Confluence accounts

Ask Claude:

List my connected Confluence 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 Confluence account.

This helps you confirm that every label points to the correct Confluence account and that you did not connect the same account twice.

Step 5: Use the right Confluence account

Mention the account name whenever you ask Claude to work with Confluence. This is especially important when an action could change data.

Review activity across accounts

Check confluence-1 and confluence-2 for anything new in Confluence from the last 14 days. Group the results by account.

Add 'urgent' label to Q3 planning page

Using the confluence-1 account, add 'urgent' label to Q3 planning page.

Publish team meeting summary as a blog post

Using the confluence-2 account, publish team meeting summary as a blog post.

Find something across accounts

Search all connected Confluence 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.

Make account selection more reliable

Add this to your Claude preferences or project instructions, replacing the examples with your own account names:

My Confluence accounts are: confluence-1 = my main account, confluence-2 = my second account, and confluence-3 = a client account. Always use the named account when I specify one. If I do not name an account, ask me which one to use. Before creating, changing, or deleting anything, show me the planned action and wait for confirmation.

If Claude's built-in Confluence connector is also enabled, Claude may use it instead of Composio. For a clearer setup, turn off the built-in connector or explicitly tell Claude to use Confluence through Composio.

Manage accounts from the Composio dashboard

The chat method is the quickest way to connect accounts. Use the dashboard when you want to add, rename, reconnect, or remove a connection.

  1. Go to dashboard.composio.dev.
Composio dashboard Apps page with Connect buttons for each app
  1. Sign in with the same Composio account you connected to Claude.
  2. Open For You from the product switcher.
  3. Find Confluence.
  4. Click Connect and complete the Confluence authorisation flow.
  5. Click Connect again to add another Confluence account. Composio keeps it as a separate connection instead of replacing the first.
  6. Give each connection a clear label, such as confluence-1, confluence-2, or confluence-3.

If Confluence opens the wrong account during authorisation, sign out first or use an incognito or private window.

From the dashboard, you can also:

  • Rename a connection when a default label such as confluence-2 is no longer useful.
  • Disconnect or delete an account you no longer want Claude to access.
  • Re-authorise an expired or revoked connection.

Troubleshooting

Why isn't the Composio connector appearing or staying enabled in Claude?

Open Claude's connector settings and confirm that Composio is installed and enabled for the current account or workspace. If you use Claude Team or Enterprise, a workspace Owner may need to add or approve it. If the connector was removed, add it again and sign in with the same Composio account you used before.

Why is Claude using the wrong Confluence account after I specify an account name?

Ask Claude to list your connected Confluence accounts, including each connection name, account ID, and status. Make sure your prompt uses the exact name shown in Composio. Rename vague or duplicate labels, then try again with a clear instruction such as: Use Confluence through Composio with the confluence-2 account.

Why is Claude using its built-in Confluence connector instead of Composio?

Turn off Claude's built-in Confluence connector, or explicitly tell Claude to use Confluence through Composio. If Claude keeps choosing the built-in connector because of earlier chat context, start a new chat and mention the Composio connection name in your first request.

Why isn't my second Confluence account appearing as a separate connection in Composio?

The second authorisation may have reopened your first Confluence account. Check the account ID for each connection in Composio. If both connections point to the same account, remove the duplicate and reconnect using an incognito or private window so you can sign in to the correct Confluence account.

Why does my Confluence connection show as expired or inactive in Composio?

Open the Composio dashboard, find Confluence, and reconnect or re-authorise the affected account. Complete Confluence's permission flow, then return to Claude and ask it to list your connections again. The account should now show as ACTIVE.

FAQ

Frequently asked questions

Yes. Repeat the same connection process for each Confluence account and give every connection a unique name, such as confluence-1, confluence-2, or client-acme.

No. You add Composio to Claude once. Composio then manages the individual Confluence connections behind that single connector.

Claude uses the connection name you provide. Include that exact name in your prompt, for example: Use the confluence-2 Confluence account through Composio. If you do not specify an account, ask Claude to confirm one before taking action.

Yes. Connect them separately and use clear names such as confluence-1 and confluence-3. Always include the account name in prompts that create or change Confluence data.

Yes. Open the Composio dashboard and find Confluence to manage your connections. You can give a connection a clearer name, re-authorise an expired account, or disconnect an account you no longer use.

Claude can only perform actions made available through the connected Confluence tools and the permissions you approved. For sensitive actions such as creating, changing, or deleting data, ask Claude to show the planned action and wait for your confirmation before proceeding.

Start with Confluence.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Confluence tool your agent needs.Free to start.

Start building