# @kody/canva-mcp

Official Canva “C” mark. Canva® is a trademark of Canva. This package is not
affiliated with or endorsed by Canva.

## Intent

Wrap the official Canva MCP server (`kody.mcp["canva"]`) so
onboarding is add-server-and-authorize. This package is the MCP helper.
The existing OAuth/API package `@kody/canva` stays separate.

This listing is meant to be forked. After you fork, connect **your**
Canva workspace. Do not treat the live `@kody/canva-mcp` connection
as yours.

Share this listing as https://kody.codes/@kody/canva-mcp

## What it does

- Probe whether the Canva MCP server is connected (or report setup)
- List Canva designs the authorizing user can already see
- Prefer official MCP over registering a custom Canva OAuth app

## Prerequisites / setup

**Preferred:** add the official Canva MCP server, then authorize it.

```ts
await kody.mcpServerAdd({
  name: 'canva',
  url: 'https://mcp.canva.com/mcp',
})
```

Open the returned `authUrl`. Helpers then call `kody.mcp["canva"]`. The MCP
*server* name stays `canva`. The `-mcp` suffix is only the Kody package
identity.

Do not register a Canva OAuth app for the one-click path. For OAuth or
API-key helpers, use `@kody/canva`.

Agents: see [`AGENTS.md`](./AGENTS.md) for import paths and smoke checks.

## Done when

- Canva MCP server `canva` is added and authorized
- Smoke test reports MCP connected (or clear setup / `@kody/canva` fallback)
- `list-designs` returns designs the user can already see

## Branding

`community-icon.svg` is Canva's official mark. Canva® is a trademark of
Canva. This package is not affiliated with or endorsed by Canva.