X (Twitter)LinkedInGitHubDiscordYouTube

How to connect Bannerbear to Claude

Connect Claude Web, Desktop and Cowork to Bannerbear MCP. Merge multiple marketing pdfs into one file, list all video assets created this week, and more using natural language, with authentication handled for you.

Get started for freeGet a demo
Bannerbear logoBannerbear
Api Key

Bannerbear is an API-driven platform for generating images and videos automatically at scale. It helps businesses create custom graphics, social visuals, and marketing assets using powerful templates.

33 Tools

Introduction

Claude is Anthropic's AI assistant, available on the web, in the desktop app, and on mobile. Cowork is its agent for knowledge work, and it runs on all of those surfaces too. Connected to your apps, Claude can work with your files and services to accomplish complex tasks on your behalf.

This guide walks you through the easiest and most secure way to connect your Bannerbear account to Claude via Composio Connect, enabling it to merge multiple marketing PDFs into one file, list all video assets created this week, get available fonts for Instagram templates, and more such actions on your behalf without compromising your account security.

Setup is the same on Claude Web, Desktop, and Cowork, and you only need to do it once. The connector is tied to your account, so it's available in all three.

Also integrate Bannerbear with

Claude CodeOpenAI Agents SDKClaude Agent SDKCodexOpenClawHermesAtomic AgentGoogle ADKLangChainVercel AI SDKMastra AILlamaIndexCrewAIPydantic AIAutoGen

Connecting Bannerbear to Claude Web, Desktop, and Cowork

Two ways to add the Composio connector. Pick whichever you prefer.

1. Add with one click

Click the button. Claude opens with the Composio connector filled in. Click Add, then go to step 2.

Add to Claude

Add manually

In Claude Desktop, click Customize in the left sidebar, then select Connectors and click the + icon at the top.

Claude Desktop connectors screen with Add custom connector selected

Click Add custom connector and paste in the Composio MCP server URL:

bash
https://connect.composio.dev/mcp
Add custom connector dialog with Composio MCP server URL

2. Authorize in your browser

Click Connect. You'll be redirected to a browser window where you can authorize Composio to continue.

Composio authorization screen for Claude Web, Desktop, and Cowork

3. Connect your Bannerbear account

Back in Claude, ask it to connect to Bannerbear or give it any Bannerbear-related task.

For example, ask Claude to:

  • "Merge multiple marketing PDFs into one file"
  • "List all video assets created this week"
  • "Get available fonts for Instagram templates"

It will prompt you to authenticate and authorize access.

That's it. Composio's tools are now available in Claude, and your Bannerbear account is ready to use.

What is the Bannerbear Claude Connector, and what's possible with it?

The Bannerbear MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Bannerbear account. It provides structured and secure access to your Bannerbear workspace, so your agent can generate images, create videos, manage templates, merge PDFs, and retrieve creative assets on your behalf.

  • Automated image and video generation: Enable your agent to create customized graphics or videos at scale using your Bannerbear templates and project assets.
  • Template browsing and management: Let your agent list, inspect, and select templates or template sets for creative projects, making it easy to automate content workflows.
  • Font and asset discovery: Have your agent retrieve available fonts and signed bases, ensuring the right design elements are used for every creative output.
  • PDF merging automation: Direct your agent to combine multiple PDFs into a single document, streamlining report or collateral creation.
  • Account and usage monitoring: Allow your agent to fetch current account status, API usage, and quota information to keep your creative operations running smoothly.

Troubleshooting

1. Why does Claude not use the Composio connector for Bannerbear?

The connector can show as connected, but Claude must use it in each Bannerbear conversation.

  • Click + at the lower left of the chat, or type /.
  • Hover Connectors.
  • Turn on Composio.
  • Ask Claude to connect to Bannerbear again.

2. Why does Claude show an MCP server error before Bannerbear connects?

Claude can show Couldn't reach the MCP server or Authorization with the MCP server failed when you add the connector for Bannerbear.

  • Check that the connector URL is https://connect.composio.dev/mcp.
  • Connectors run from Anthropic's cloud, so your device network is usually not the problem.
  • Add the connector again from Customize > Connectors, then ask Claude to connect Bannerbear.
  • If it fails again, send the error and the ofid_ reference id to support@composio.dev.

3. Why does the Bannerbear authorization link not work?

The Composio connector is one server. Your Bannerbear account connects separately when Claude asks for it.

  • If the browser does not open, or the link expires, ask Claude to retry the Bannerbear connection.
  • Composio creates a fresh Bannerbear authorization link.
  • Open that link in your browser and finish the Bannerbear sign-in.

4. Why do Bannerbear actions fail after they worked before?

The Bannerbear connection can expire or lose permission.

  • Ask Claude to inspect the Bannerbear connection.
  • If the connection is unhealthy, disconnect it when Claude prompts you.
  • Reconnect the Bannerbear account and retry the action.
  • If Claude shows a permission prompt, approve it before Claude changes data in Bannerbear.
  • If the action still fails with a permission error, check that the connected account has that permission in Bannerbear itself.

5. How do I switch to a different Bannerbear account?

Claude can manage the Bannerbear connection for you.

  • Ask Claude to disconnect or delete the current Bannerbear account.
  • Ask Claude to connect Bannerbear again.
  • Open the new Composio authorization link for Bannerbear.
  • Sign in with the other Bannerbear account in the browser.
  • After the account connects, ask Claude to retry the Bannerbear task.

6. Why is my Bannerbear connection missing in Claude Desktop or on a Team plan?

The connector belongs to your Claude account, so your Bannerbear connection works in Claude Web, Desktop, and Cowork.

  • In Claude Desktop, open Customize > Connectors.
  • Next to Composio, click ⋮ and click Clear cache.
  • If Bannerbear tools still do not appear, click ⋮, disconnect, remove the connector, and add it again.
  • On Team or Enterprise, an Owner or Primary Owner must enable the connector before you can connect Bannerbear.
TOOLS

Supported Tools

Every Bannerbear action and event your agent gets out of the box.

Create Project

Creates a new Bannerbear project with the specified name and optional settings.

Create Signed Base

Tool to create a signed URL base for a template.

Create Template

Create a new blank template in a Bannerbear project.

Create Template Set

Tool to create a new template set by grouping multiple templates together.

Create Video Template

Tool to create a new video template for video generation in Bannerbear.

Create Webhook

Create a project-level webhook that fires for all events of a specific type.

Delete Template

Tool to delete a template referenced by its unique ID.

Delete Webhook

Tool to delete a webhook referenced by its unique ID.

Get Account Info

Retrieves Bannerbear account information including subscription plan, API usage, and quota limits.

Get Animated GIF

Tool to retrieve a single Animated Gif object by its unique identifier (UID).

Get Auth Status

Verify API authentication and check which project the API key is scoped to.

Get Available Fonts

This tool retrieves a list of all available fonts in Bannerbear.

Get Image

Retrieves a single Image object by its unique identifier (UID).

Get Project

Retrieves detailed information about a specific Bannerbear project by its unique identifier (UID).

Get Screenshot

Retrieve a single Screenshot object referenced by its unique ID.

Get Signed Bases

This tool retrieves a list of signed bases for a specific template.

Get Template

Tool to retrieve a single template by its unique ID with layer defaults.

Get Template Set Details

This tool retrieves detailed information about a specific template set using its unique identifier (UID).

Get Webhook

Retrieves a single Webhook object by its unique ID.

Hydrate Project

Hydrate a project by copying templates from another project.

Import Template

Tool to import templates from the Bannerbear template library or from other projects.

Join PDFs

Merges multiple PDF files into a single combined PDF document.

List Animated GIFs

Lists all animated GIFs in a Bannerbear project.

List Collections

Lists all collections in a Bannerbear project.

List Effects

Tool to list all available image effects in Bannerbear.

List Images

Lists all images in a Bannerbear project.

List Projects

Lists all projects in a Bannerbear account.

List Screenshots

Lists all screenshots in a Bannerbear project.

List Templates

This action retrieves a list of all templates available in your Bannerbear project.

List Template Sets

Tool to list all template sets inside a project with pagination support.

List Videos

This action retrieves a list of all videos created in your Bannerbear account.

List Video Templates

This action retrieves a list of all video templates available in your Bannerbear project.

Update Template Set

Tool to update a template set by modifying its list of templates.

FRAMEWORKS

How to build Bannerbear MCP Agent with another framework

Claude Code logo

Claude Code

Use Bannerbear MCP with Claude Code

OpenAI Agents SDK logo

OpenAI Agents SDK

Use Bannerbear MCP with OpenAI Agents SDK

Claude Agent SDK logo

Claude Agent SDK

Use Bannerbear MCP with Claude Agent SDK

Codex logo

Codex

Use Bannerbear MCP with Codex

OpenClaw logo

OpenClaw

Use Bannerbear MCP with OpenClaw

Hermes logo

Hermes

Use Bannerbear MCP with Hermes

Atomic Agent logo

Atomic Agent

Use Bannerbear MCP with Atomic Agent

Google ADK logo

Google ADK

Use Bannerbear MCP with Google ADK

LangChain logo

LangChain

Use Bannerbear MCP with LangChain

Vercel AI SDK logo

Vercel AI SDK

Use Bannerbear MCP with Vercel AI SDK

Mastra AI logo

Mastra AI

Use Bannerbear MCP with Mastra AI

LlamaIndex logo

LlamaIndex

Use Bannerbear MCP with LlamaIndex

CrewAI logo

CrewAI

Use Bannerbear MCP with CrewAI

Pydantic AI logo

Pydantic AI

Use Bannerbear MCP with Pydantic AI

AutoGen logo

AutoGen

Use Bannerbear MCP with AutoGen

FAQ

Frequently asked questions

With a standalone Bannerbear MCP server, the agents and LLMs can only access a fixed set of Bannerbear tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from Bannerbear and many other apps based on the task at hand, all through a single MCP endpoint.

Yes, you can. Claude Cowork fully supports MCP integration. You get structured tool calling, message history handling, and model orchestration while Tool Router takes care of discovering and serving the right Bannerbear tools.

Yes, absolutely. You can configure which Bannerbear scopes and actions are allowed when connecting your account to Composio. You can also bring your own OAuth credentials or API configuration so you keep full control over what the agent can do.

All sensitive data such as tokens, keys, and configuration is fully encrypted at rest and in transit. Composio is SOC 2 Type 2 compliant and follows strict security practices so your Bannerbear data and credentials are handled as safely as possible.

Start with Bannerbear.It takes 30 seconds.

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

Start building