For AI assistants

CardShare.ai MCP server

Make, edit and schedule group greeting cards from a chat. Add one URL to Claude, ChatGPT, Grok, Cursor, Claude Code or Codex, sign in once, and ask for a card.

Server URL

https://www.cardshare.ai/mcp

FreeOAuth sign-in, no API key · 6 apps · 11 tools

Set it up

Connect your app

Each app signs in to your CardShare.ai account in the browser the first time it uses a tool. Sign in or create a free account with Google, GitHub or email, then click Allow.

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 for 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 for 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 for 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 for 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

What your assistant can do

Every tool works on the account you sign in with. Your assistant picks the tool from what you ask, so you don't need to name them.

Make a card

  • create_cardMakes 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_photoMakes 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_templatesRead-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_cardsRead-only

    Lists the cards you've made, newest first, with their status and links.

  • get_cardRead-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_cardMakes 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_sendEmails 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_sendMakes or changes cards

    Cancels a card's scheduled send. The card and everyone's notes stay as they are.

Teams

  • find_teammateRead-only

    Finds someone on your CardShare.ai teams by name, with their team and whether they have a photo.

  • upcoming_datesRead-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_teammateMakes 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.

For developers

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

Questions

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.

Something not working? See the troubleshooting on the Claude and ChatGPT guides, or email cardshareai@gmail.com.