# CardShare.ai MCP server

Connect CardShare.ai's MCP server to Claude, ChatGPT, Grok, Cursor, Claude Code or Codex to make group greeting cards from a chat. Setup and every tool.

Server URL: https://www.cardshare.ai/mcp

## Connect your app

### Claude

Add a custom connector on claude.ai with the server URL, then sign in. Works on every Claude plan, in the browser, the desktop app and on your phone.

Step-by-step guide: https://www.cardshare.ai/claude

### ChatGPT

Create a custom MCP server from ChatGPT's Plugins page with the server URL and OAuth, then sign in and mention CardShare.ai in a chat.

Step-by-step guide: https://www.cardshare.ai/chatgpt

### Grok

On grok.com, open Connectors and add a custom connector with the server URL, then sign in and click Allow.

Step-by-step guide: https://www.cardshare.ai/grok

### Cursor

Click Add to Cursor on the Cursor guide, or add the server to `~/.cursor/mcp.json` to use it in every project (`.cursor/mcp.json` for one project).

~/.cursor/mcp.json:

```
{
  "mcpServers": {
    "cardshare": {
      "url": "https://www.cardshare.ai/mcp"
    }
  }
}
```

Then open Cursor Settings → Tools & MCP and click Connect next to cardshare. Your browser opens to sign in and allow access.

Step-by-step guide: https://www.cardshare.ai/cursor

### Claude Code

Add the server from your terminal. `--scope user` makes it available in every project, not just the current one.

Terminal:

```
claude mcp add --transport http --scope user cardshare https://www.cardshare.ai/mcp
```

Then run `/mcp` in Claude Code, pick cardshare and choose Authenticate. Your browser opens to sign in and allow access.

### Codex

Add the server with the Codex CLI, or in `~/.codex/config.toml`, which the CLI and the IDE extension share.

Terminal:

```
codex mcp add cardshare --url https://www.cardshare.ai/mcp
codex mcp login cardshare
```

~/.codex/config.toml:

```
[mcp_servers.cardshare]
url = "https://www.cardshare.ai/mcp"
```

`codex mcp login` opens your browser to sign in and allow access. With the config file, run it once after saving.

## Tools

### Make a card

- `create_card` (Makes or changes cards): Makes a card from who it's for, who it's from, the occasion, a tone and a few personal details. The headline is written and an illustrated cover drawn in 20 to 40 seconds.
- `create_card_from_photo` (Makes or changes cards): Makes a card whose cover is drawn from your photo, optionally in a photo scene. ChatGPT can pass a photo attached to the chat; otherwise a photo picker opens in the chat.
- `list_templates` (Read-only): Lists the photo scenes a cover can put someone into, like an astronaut or a Renaissance portrait, with the occasions each suits.

### Your cards

- `list_cards` (Read-only): Lists the cards you've made, newest first, with their status and links.
- `get_card` (Read-only): Shows one card: its headline, names, your message, how many people have signed, and its links to edit, invite people and view it.
- `update_card` (Makes or changes cards): Changes a card's headline, the recipient or sender names, or your own message inside. Anything not mentioned stays as it is.

### Sending

- `schedule_card_send` (Emails the recipient): Emails a card to its recipient at a date and time you choose, replacing any send already set. People signing see it as the time to sign by.
- `cancel_scheduled_send` (Makes or changes cards): Cancels a card's scheduled send. The card and everyone's notes stay as they are.

### Teams

- `find_teammate` (Read-only): Finds someone on your CardShare.ai teams by name, with their team and whether they have a photo.
- `upcoming_dates` (Read-only): Lists the birthdays and work anniversaries coming up on your teams, with whether each card has been started. It never mentions a card for your own date.
- `create_card_for_teammate` (Makes or changes cards): Makes a card for a teammate in their team, hidden from them, with their team photo on the cover when they have one.

## How the connection works

- Server URL: https://www.cardshare.ai/mcp
- Transport: Streamable HTTP
- Sign-in: OAuth 2.1 with PKCE and dynamic client registration. There's no API key to copy: you sign in with Google, GitHub or email and click Allow
- Discovery: An unsigned request gets a 401 that points to /.well-known/oauth-protected-resource/mcp, which names the authorization server
- Server card: /mcp/server-card, listed in /.well-known/ai-catalog.json
- Access: Only the account you sign in with: the cards you made, and the people and dates on your teams. A teammate's card for you stays hidden
- Limits: 10 card or cover generations every 10 minutes per account, counted with the website's daily cover allowance

## Good to know

### Is the CardShare.ai MCP server free?

Yes. Connecting it, making cards, collecting signatures and sending them are free, with no credit card needed.

### Do I need an API key?

No. Every app signs in with OAuth: you sign in to CardShare.ai in your browser and click Allow, and the app gets its own access to your account. Disconnect it from the app at any time.

### Which apps can I use it in?

Claude (web, desktop and mobile), ChatGPT, Grok, Cursor, Claude Code and Codex. Other MCP apps work when they finish sign-in on your own computer, as Claude Code and Codex do. Sign-in for other web apps is turned down for now, so nobody can collect access to your account through an app we haven't checked.

### Can my assistant send a card without asking me?

Scheduling a send is the only tool that emails anyone, and it only goes to the address you give it. Assistants are told to confirm the time with you first, and you can cancel a scheduled send until it goes out.

### What happens to photos I give it?

A photo is only used to draw the card's cover, and we don't keep it.

### Can it move notes, add GIFs or change pages?

Not from the chat. Every card the assistant shows you has an edit link that opens it on the website, where you can do everything else.


---

Source: https://www.cardshare.ai/mcp-server
