# Termcard

> Termcard is an open-source MCP server for productivity. Create and look up terminal business cards that anyone opens with one npx command. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, macOS, Linux, Windows
- **Website:** https://termcard.dev
- **Repository:** https://github.com/aepasahan/termcard/tree/HEAD/packages/termcard
- **MCP Registry name:** io.github.aepasahan/termcard
- **Categories:** productivity
- **Listing updated:** 2026-11-14

## About

A Termcard is a card you describe once in a JSON file; the engine draws it, runs its menu and handles languages. Visitors run npx and your name, then get in touch by email draft, save a vCard, open profiles or copy your details. There are 14 languages including right-to-left ones, eight seasonal themes and three layouts.

The MCP server adds an assistant layer. In Claude you can build a card by chatting, look up anyone's published card by name, save them as a contact or draft an email to them. Nothing is published or sent on your behalf, and the card links are limited to web, email and phone.

It connects over stdio with npx -y termcard mcp, or remotely at mcp.termcard.dev with no sign-in, and also ships as a Claude Desktop extension and a Claude Code plugin. Needs Node.js 18.18 or newer. The package is MIT licensed with zero dependencies and no tracking of visitors.

## Features

- **One-command cards:** Publish a card visitors open with npx.
- **Chat-based creation:** Describe your card to an assistant instead of writing the config.
- **Contact lookup:** Find a published card and save it as a contact.
- **14 languages:** Detects the visitor's language, including right-to-left.
- **Eight themes:** Seasonal colours that suit dark and light terminals.
- **No tracking:** Values are validated and sanitised; visitors are not tracked.

## Good for

- Publish a business card for developers
- Look up how to reach someone with a card
- Draft an email to a card owner
- Build a card from a conversation

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http termcard https://mcp.termcard.dev/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://mcp.termcard.dev/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "termcard": {
      "url": "https://mcp.termcard.dev/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "termcard": {
      "type": "http",
      "url": "https://mcp.termcard.dev/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "termcard": {
      "serverUrl": "https://mcp.termcard.dev/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "termcard": {
      "type": "http",
      "url": "https://mcp.termcard.dev/mcp"
    }
  }
}
```

## Tools

- `get_card`: Returns a person's Termcard business card: name, role, description, location, email, phone, website and profile links.
- `get_vcard`: Returns the person's contact details as a vCard 3.0 text that can be saved to an address book.
- `compose_email`: Prepares an email to the card's owner and returns a mailto: link for the user to open, review and send. Nothing is sent automatically.
- `list_card_options`: Explains what a Termcard card can contain — fields, limits, templates, color themes, icon sets, languages and menu items — with an example config. Call this before drafting a card.
- `preview_card`: Validates a card config and returns a text preview of the card and its menu, or the list of problems to fix. Use it after every change and show the preview to the user.
- `check_name`: Checks whether a name can be used as the card's npm package (people will run `npx <name>`) and whether it is still free on npm.
- `export_card_config`: Returns the finished card.config.json for the user to save, with the commands that turn it into a published card. Use it where files cannot be written for the user (for example in a web chat).

## FAQ

### Do I need an account?

No sign-in is needed for the remote connector.

### What do visitors type?

npx followed by the card owner's name.

### Does the assistant send things for me?

No, nothing is published or sent on your behalf.

### What are the requirements?

Node.js 18.18 or newer on macOS, Linux or Windows.

### Is Termcard free?

Yes. Termcard is open source, so you can use and self-host it for free.

### How do I add Termcard to Claude Code?

Run this command in your terminal: claude mcp add --transport http termcard https://mcp.termcard.dev/mcp

### What are the best alternatives to Termcard?

The closest alternatives to Termcard are Ha MCP, Concord MCP, note1, CalderFlow and nicemails.

## Alternatives

- [Ha MCP](https://ai-powered.com/mcp/ha-mcp): Ha MCP is an open-source MCP server for productivity.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.
- [CalderFlow](https://ai-powered.com/mcp/calderflow): CalderFlow is a free MCP server for design and media.
- [nicemails](https://ai-powered.com/mcp/nicemails): nicemails is a freemium MCP server for communication.
- [ConvertAudioToText](https://ai-powered.com/mcp/convertaudiototext): ConvertAudioToText is a freemium MCP server for design and media.
- [MeetBetr](https://ai-powered.com/mcp/meetbetr): MeetBetr is a free MCP server for productivity.
- [Hostlet](https://ai-powered.com/mcp/hostlet): Hostlet is a free MCP server for productivity.

---
Source: https://ai-powered.com/mcp/termcard
