Canva MCP server for AI agents

Let Claude, ChatGPT or your own agent read Canva: 27 typed functions through one MCP server. No Canva API key needed.

Functions
27
Sign-in
For account actions
Works with
MCP, HTTP, Node, Python

Connect

Just Canva

An MCP server for Canva alone, with one tool per function. Paste it into Claude, ChatGPT, Cursor or any MCP client as a remote server.

https://api.bowmark.ai/mcp/site/canva
Every site

One MCP server for Canva and every other site Bowmark covers. Your agent looks up what it needs and calls it.

https://api.bowmark.ai/mcp
Set it up in your client

Both need a Bowmark API key. The quickstart gets you one and a first result in a few minutes. Functions that need a login use the person's own account: how sign-in works.

Functions

Open a function to see its arguments, what it returns and how to call it.

Read 27
  • browseTemplatesLists the templates in one design type (and optional sub-theme, e.g. invitations/birthday).

    Arguments

    NameTypeRequired
    categorystringYes

    Returns { templates: CanvaTemplate[]; url: string; warnings: string[] }

    interface CanvaTemplatePreviewImage {
      url: string;
      width: number;
      height: number;
    }
    
    interface CanvaTemplate {
      id: string;
      title: string;
      url: string;
      previewImages: CanvaTemplatePreviewImage[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/canva/browseTemplates

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.canva.browseTemplates("/flyers/templates/");
  • getAppReads one Canva app's marketplace page by id or url.

    Arguments

    NameTypeRequired
    idOrUrlstringYes

    Returns CanvaAppDetail

    interface CanvaApp {
      id: string;
      name: string;
      tagline: string | null;
      developer: string | null;
      /** Marketplace topics, e.g. "videos", "text_effects". */
      topics: string[];
      /** "free", "paid", "freemium" … */
      pricing: string | null;
      users: number | null;
      iconUrl: string | null;
      url: string;
    }
    
    interface CanvaAppDetail extends CanvaApp {
      description: string | null;
      tags: string[];
      platforms: string[];
      publishedAt: string | null;
      updatedAt: string | null;
      helpUrl: string | null;
      developerUrl: string | null;
      imageUrl: string | null;
      related: CanvaApp[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/canva/getApp

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.canva.getApp("<idOrUrl>");
  • getColorCombinationsReturns the colour-wheel combinations for one hex colour.

    Arguments

    NameTypeRequired
    hexstringYes

    Returns CanvaColorCombinations

    interface CanvaColorCombinations {
      hex: string;
      complementary: string[];
      analogous: string[];
      triadic: string[];
      splitComplementary: string[];
      tetradic: string[];
      monochromatic: string[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/canva/getColorCombinations

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.canva.getColorCombinations("#FF0000");
  • getColorMeaningReads Canva's page on one colour by name.

    Arguments

    NameTypeRequired
    colorNamestringYes

    Returns CanvaColorMeaning

    interface CanvaNamedColor {
      slug: string;
      name: string;
      hex: string;
    }
    
    interface CanvaColorMeaning {
      slug: string;
      name: string;
      hex: string;
      rgb: { r: number; g: number; b: number } | null;
      meaning: string[];
      relatedColors: { slug: string; name: string }[];
      palettes: { slug: string; name: string; colors: string[] }[];
      otherColors: CanvaNamedColor[];
      readMoreUrl: string | null;
      updated: string | null;
      url: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/canva/getColorMeaning

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.canva.getColorMeaning("red");
  • getColorPaletteReads one curated colour palette by slug.

    Arguments

    NameTypeRequired
    slugstringYes

    Returns CanvaColorPaletteDetail

    interface CanvaColorPaletteColor {
      slug: string;
      hex: string;
      name: string;
    }
    
    interface CanvaColorPaletteDetail {
      id: string;
      slug: string;
      name: string;
      colors: CanvaColorPaletteColor[];
      url: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/canva/getColorPalette

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.canva.getColorPalette("<slug>");
  • getCreatorReads a Canva creator's public profile by handle or /p/ url.

    Arguments

    NameTypeRequired
    handleOrUrlstringYes

    Returns { creator: CanvaCreator; warnings: string[] }

    interface CanvaCreatorMediaImage {
      url: string;
      width: number;
      height: number;
    }
    
    interface CanvaCreatorMedia {
      id: string;
      title: string | null;
      url: string;
      images: CanvaCreatorMediaImage[];
    }
    
    interface CanvaCreator {
      id: string;
      handle: string;
      name: string;
      bio: string | null;
      website: string | null;
      followers: number;
      media: CanvaCreatorMedia[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/canva/getCreator

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.canva.getCreator("billionphotos");
  • getDesignReads one of the caller's designs by id or edit url.

    Arguments

    NameTypeRequired
    idOrUrlstringYes

    Returns { design: CanvaDesign; warnings: string[] }

    interface CanvaDesign {
      id: string;
      title: string;
      editUrl: string;
      viewUrl: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/canva/getDesign

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.canva.getDesign("DACHZTlgWkU");
  • getDesignContentReads the text and page images of one of the caller's designs, or of one page (pass a page number, counting from 1).

    Arguments

    NameTypeRequired
    idOrUrlstringYes
    pageNumbernumberNo

    Returns { design: CanvaDesignContent; pages: CanvaDesignPage[]; warnings: string[] }

    interface CanvaDesignContent {
      id: string;
      title: string;
      url: string;
      pageCount: number;
    }
    
    interface CanvaDesignPage {
      page: number;
      /** This page's own text, joined in on-page order. Empty when the page carries no text. */
      text: string;
      imageUrl: string;
      width: number;
      height: number;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/canva/getDesignContent

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.canva.getDesignContent("DACHZTlgWkU");
  • getGraphicReads one graphic by id or url.

    Arguments

    NameTypeRequired
    idOrUrlstringYes

    Returns CanvaGraphicDetail

    interface CanvaPhotoImage {
      url: string;
      width: number;
      height: number;
    }
    
    interface CanvaGraphicDetail {
      id: string;
      title: string | null;
      url: string;
      description: string | null;
      /** Canva's category token, e.g. "ICONS". */
      category: string | null;
      licence: "free" | "pro";
      creator: { id: string; name: string; avatarUrl: string | null } | null;
      /** Hex colours from the page's colour bar, dominant first. */
      colors: string[];
      images: CanvaPhotoImage[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/canva/getGraphic

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.canva.getGraphic("<idOrUrl>");
  • getMyProfileReads the signed-in caller's Canva profile.

    Arguments

    None.

    Returns { profile: CanvaMyProfile; warnings: string[] }

    interface CanvaMyProfile {
      /** Canva's account id. */
      id: string;
      name: string;
      handle: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/canva/getMyProfile

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.canva.getMyProfile();
  • getPhotoReads one stock photo by id or url.

    Arguments

    NameTypeRequired
    idOrUrlstringYes

    Returns CanvaPhotoDetail

    interface CanvaPhotoImage {
      url: string;
      width: number;
      height: number;
    }
    
    interface CanvaPhotoDetail {
      id: string;
      title: string | null;
      url: string;
      description: string | null;
      licence: "free" | "pro";
      /** null when the photo links no creator. */
      creator: { name: string; url: string | null } | null;
      /** Hex colours from the page's colour bar, dominant first. */
      colors: string[];
      images: CanvaPhotoImage[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/canva/getPhoto

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.canva.getPhoto("<idOrUrl>");
  • getPricingReads Canva's paid plans (Pro, Business) with each one's monthly and yearly price, currency, whether it is per person, and the free-trial length.

    Arguments

    None.

    Returns { plans: CanvaPlan[]; url: string; warnings: string[] }

    interface CanvaPrice {
      id: string;
      interval: "month" | "year";
      currency: string;
      /** Major units, e.g. 18 (dollars). */
      amount: number;
      /** True for a per-person price (Business). */
      perPerson: boolean;
    }
    
    interface CanvaPlan {
      /** "Canva Pro" | "Canva Business"; null when the pricing model is unrecognised. */
      name: string | null;
      planId: string;
      trialDays: number | null;
      prices: CanvaPrice[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/canva/getPricing

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.canva.getPricing();
  • getSharedDesignReads a Canva design someone shared by view link (canva.com/design/<id>/<token>/view, token optional).

    Arguments

    NameTypeRequired
    linkOrIdstringYes

    Returns CanvaSharedDesign

    interface CanvaSharedDesignPage {
      page: number;
      /** This page's own text, joined in on-page order. Empty for a photo-only page. */
      text: string;
      imageUrl: string;
      width: number;
      height: number;
    }
    
    interface CanvaSharedDesign {
      id: string;
      title: string;
      url: string;
      pageCount: number;
      pages: CanvaSharedDesignPage[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/canva/getSharedDesign

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.canva.getSharedDesign("DACHZTlgWkU");
  • getTemplateReads one template by id or url.

    Arguments

    NameTypeRequired
    idOrUrlstringYes

    Returns CanvaTemplateDetail

    interface CanvaTemplatePreviewImage {
      url: string;
      width: number;
      height: number;
    }
    
    interface CanvaTemplateCreator {
      name: string;
      url: string | null;
    }
    
    interface CanvaTemplateDetail {
      id: string;
      title: string;
      url: string;
      description: string | null;
      designType: string | null;
      creator: CanvaTemplateCreator | null;
      pageImages: CanvaTemplatePreviewImage[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/canva/getTemplate

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.canva.getTemplate("<idOrUrl>");
  • listColorPalettesLists Canva's curated colour palettes (name, hex colours, page url), paged.

    Arguments

    NameTypeRequired
    pagenumberNo

    Returns { palettes: CanvaColorPalette[]; page: number; pageCount: number; warnings: string[] }

    interface CanvaColorPalette {
      id: string;
      slug: string;
      name: string;
      colors: string[];
      url: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/canva/listColorPalettes

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.canva.listColorPalettes();
  • listDesignPagesLists the pages of one of the caller's designs with each page's thumbnail (no text).

    Arguments

    NameTypeRequired
    idOrUrlstringYes

    Returns { design: CanvaDesignContent; pages: CanvaDesignPageThumb[]; warnings: string[] }

    interface CanvaDesignContent {
      id: string;
      title: string;
      url: string;
      pageCount: number;
    }
    
    interface CanvaDesignPageThumb {
      page: number;
      imageUrl: string;
      width: number;
      height: number;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/canva/listDesignPages

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.canva.listDesignPages("DACHZTlgWkU");
  • listDesignSizesReads Canva's design-size wiki for one platform or format (Instagram, YouTube, business card, …).

    Arguments

    NameTypeRequired
    topicstringNo

    Returns CanvaDesignSizes

    interface CanvaDesignSizeTopic {
      slug: string;
      title: string;
      category: string;
    }
    
    interface CanvaDesignSize {
      name: string;
      widthCm: number;
      heightCm: number;
      widthIn: number;
      heightIn: number;
      widthPx: number;
      heightPx: number;
    }
    
    interface CanvaDesignSizes {
      slug: string | null;
      title: string | null;
      category: string | null;
      unit: string | null;
      columns: string[];
      sizes: CanvaDesignSize[];
      topics: CanvaDesignSizeTopic[];
      url: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/canva/listDesignSizes

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.canva.listDesignSizes();
  • listFolderItemsLists what is in one of the caller's folders.

    Arguments

    NameTypeRequired
    folderIdstringYes
    kind"design" | "upload" | "folder"No

    Returns { items: CanvaFolderItem[]; warnings: string[] }

    interface CanvaFolderItem {
      id: string;
      name: string;
      /** "design", "upload" or "folder". */
      kind: "design" | "upload" | "folder";
      /** null for an upload. */
      url: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/canva/listFolderItems

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.canva.listFolderItems("FAFhxhf3hxg");
  • listFoldersLists the caller's folders (and subfolders of one folder).

    Arguments

    NameTypeRequired
    folderIdstringNo

    Returns { folders: CanvaFolder[]; warnings: string[] }

    interface CanvaFolder {
      id: string;
      name: string;
      url: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/canva/listFolders

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.canva.listFolders();
  • listPrintProductsLists what Canva Print sells.

    Arguments

    NameTypeRequired
    collectionstringNo

    Returns CanvaPrintCatalog

    interface CanvaPrintFormat {
      id: string;
      label: string | null;
      sizes: { label: string | null; width: number; height: number; units: string }[];
      defaultQuantity: number | null;
    }
    
    interface CanvaPrintProduct {
      key: string;
      id: string | null;
      name: string;
      namePlural: string | null;
      description: string[];
      /** Cheapest listed price for fromQuantity items, in currency. */
      fromPrice: number | null;
      fromQuantity: number | null;
      currency: string | null;
      collections: string[];
      formats: CanvaPrintFormat[];
      thumbnailUrl: string | null;
    }
    
    interface CanvaPrintCatalog {
      products: CanvaPrintProduct[];
      collections: { key: string; label: string; count: number }[];
      currency: string | null;
      url: string;
      warnings: string[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/canva/listPrintProducts

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.canva.listPrintProducts();
  • listTemplateCategoriesLists the design types Canva groups templates under (flyers, posters, Instagram posts, resumes, presentations, …) with each one's template-listing…

    Arguments

    None.

    Returns { categories: CanvaTemplateCategory[]; warnings: string[] }

    interface CanvaTemplateCategoryThumbnail {
      url: string;
      width: number;
      height: number;
    }
    
    interface CanvaTemplateCategory {
      name: string;
      url: string;
      type: string;
      thumbnails: CanvaTemplateCategoryThumbnail[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/canva/listTemplateCategories

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.canva.listTemplateCategories();
  • listUploadsLists the images and videos the caller has uploaded to Canva.

    Arguments

    None.

    Returns { uploads: CanvaUpload[]; warnings: string[] }

    interface CanvaUpload {
      id: string;
      name: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/canva/listUploads

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.canva.listUploads();
  • searchAppsLists and searches the Canva Apps Marketplace.

    Arguments

    NameTypeRequired
    querystringNo

    Returns { apps: CanvaApp[]; total: number; url: string; warnings: string[] }

    interface CanvaApp {
      id: string;
      name: string;
      tagline: string | null;
      developer: string | null;
      /** Marketplace topics, e.g. "videos", "text_effects". */
      topics: string[];
      /** "free", "paid", "freemium" … */
      pricing: string | null;
      users: number | null;
      iconUrl: string | null;
      url: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/canva/searchApps

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.canva.searchApps("youtube");
  • searchGraphicsSearches Canva's graphics and illustrations library (stickers, icons, illustrations) by keyword.

    Arguments

    NameTypeRequired
    querystringYes

    Returns { graphics: CanvaGraphic[]; warnings: string[] }

    interface CanvaPhotoImage {
      url: string;
      width: number;
      height: number;
    }
    
    interface CanvaPhoto {
      id: string;
      title: string | null;
      url: string;
      licence: "free" | "pro";
      images: CanvaPhotoImage[];
    }
    
    interface CanvaGraphic extends CanvaPhoto {
      /** Canva's media type for the row, e.g. "RASTER". */
      mediaType: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/canva/searchGraphics

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.canva.searchGraphics("star");
  • searchMyDesignsSearches the signed-in caller's designs by title or content (or lists the most recent with no query).

    Arguments

    NameTypeRequired
    querystringNo

    Returns { designs: CanvaMyDesign[]; warnings: string[] }

    interface CanvaMyDesign {
      id: string;
      title: string;
      url: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/canva/searchMyDesigns

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.canva.searchMyDesigns();
  • searchPhotosSearches Canva's stock photo library by keyword.

    Arguments

    NameTypeRequired
    querystringYes

    Returns { photos: CanvaPhoto[]; warnings: string[] }

    interface CanvaPhotoImage {
      url: string;
      width: number;
      height: number;
    }
    
    interface CanvaPhoto {
      id: string;
      title: string | null;
      url: string;
      licence: "free" | "pro";
      images: CanvaPhotoImage[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/canva/searchPhotos

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.canva.searchPhotos("dog");
  • searchTemplatesSearches Canva's template library by keyword.

    Arguments

    NameTypeRequired
    querystringYes

    Returns { templates: CanvaTemplate[]; warnings: string[] }

    interface CanvaTemplatePreviewImage {
      url: string;
      width: number;
      height: number;
    }
    
    interface CanvaTemplate {
      id: string;
      title: string;
      url: string;
      previewImages: CanvaTemplatePreviewImage[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/canva/searchTemplates

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.canva.searchTemplates("birthday");

Use it from code