English Français العربية

termcard

Official registry Other

Create terminal business cards (npx <name>) in a chat, or look up anyone's card.

Source code Website Documentation

What can you do with termcard?

  • No code to fork or edit. Your card is a single, validated JSON file.
  • Fourteen languages built in — the world's most spoken languages plus Turkish, German and French, including right-to-left Arabic and Urdu — and you can add your own.
  • Eight seasonal color themes, from thaw to midwinter, designed to look calm on both dark and light terminals.
  • Three layouts, optional icons and a short description; choose which details appear, in what order, or show only the menu.
  • Ready for AI assistants. A built-in MCP server lets Claude and other assistants read cards and draft emails.
  • Updates reach everyone. Cards depend on termcard, so improvements arrive without republishing your card.
  • Private and safe by design. Zero dependencies, no tracking, and every value in a card is validated and sanitized before it reaches anyone's terminal.

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http termcard 'https://mcp.termcard.dev/mcp'
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "termcard": {
            "type": "http",
            "url": "https://mcp.termcard.dev/mcp"
        }
    }
}
NPM package termcard
Claude Code 
claude mcp add termcard -- npx -y termcard@0.6.0 mcp
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "termcard": {
            "command": "npx",
            "args": [
                "-y",
                "termcard@0.6.0",
                "mcp"
            ]
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. termcard
  2. What is it?
  3. What your visitors can do
  4. Features
  5. Ask your AI assistant
  6. Customizing your card
  7. Command line
  8. Requirements
  9. Project

termcard

Your business card, in the terminal.

Created by Ahmet Erkan Paşahan

What is it?

Developers and designers spend their day in the terminal, so why not meet them there? termcard turns a short description of who you are into a small interactive program that anyone can open with one command:

npx yourname

Your visitor sees a clean business card and a menu. With a few keystrokes they can write you an email, save you to their contacts, open your website and profiles, or switch the card to their own language. Nothing to install, nothing to sign up for.

Creating your own takes about two minutes and no code:

npm create termcard@latest

A short wizard asks for your details, shows a live preview, checks that your name is free on npm and publishes the card for you.

What your visitors can do

  • Get in touch — opens a new email to you in their mail app
  • Save contact — adds your vCard to their address book
  • Visit your website and profiles — LinkedIn, GitHub, X, Behance, Dribbble and more
  • Copy your email or phone number to the clipboard
  • Switch language — the card follows their system language and can be changed from the menu

Features

  • No code to fork or edit. Your card is a single, validated JSON file.
  • Fourteen languages built in — the world's most spoken languages plus Turkish, German and French, including right-to-left Arabic and Urdu — and you can add your own.
  • Eight seasonal color themes, from thaw to midwinter, designed to look calm on both dark and light terminals.
  • Three layouts, optional icons and a short description; choose which details appear, in what order, or show only the menu.
  • Ready for AI assistants. A built-in MCP server lets Claude and other assistants read cards and draft emails.
  • Updates reach everyone. Cards depend on termcard, so improvements arrive without republishing your card.
  • Private and safe by design. Zero dependencies, no tracking, and every value in a card is validated and sanitized before it reaches anyone's terminal.

Ask your AI assistant

termcard also speaks the Model Context Protocol, so AI assistants like Claude can look up any termcard card by name, save the person as a contact or draft an email to them — read-only, nothing is ever sent on your behalf.

claude mcp add termcard -- npx -y termcard mcp

For Claude Desktop there's a one-click extension, and any MCP client works — see termcard for AI assistants. Card owners can opt out with "mcp": false.

Customizing your card

Everything lives in card.config.json. Only your name is required:

{
  "name": "Jane Doe",
  "tagline": "@studio",
  "email": "jane@example.com",
  "website": "https://jane.example.com",
  "links": ["https://www.linkedin.com/in/janedoe", "https://github.com/janedoe"],
  "language": { "available": ["en", "de"] },
  "theme": "frost",
  "icons": "symbols"
}

The configuration guide covers every option, and examples/full.json shows them all together.

Command line

termcard also ships a small tool for card owners. Visitors never see or need it.

CommandWhat it does
npx termcard previewOpens your card locally, exactly as visitors will see it.
npx termcard validateChecks your config and explains any mistakes.
npx termcard mcpRuns the MCP server for AI assistants (see docs/mcp.md).
npx termcard buildOptional. Exports your card for use outside the terminal: a web page, vCards and plain-text versions, plus ready-made code so that curl yourdomain.com prints your card.

Requirements

Node.js 18.18 or newer on macOS, Linux or Windows. Visitors need nothing but npx, which comes with Node.js.

Project

This repository contains two packages:

Package
termcardRenders and runs the cards. Every card depends on it.
create-termcardThe setup wizard behind npm create termcard.

Contributions are welcome — see CONTRIBUTING.md. Please report security issues privately as described in SECURITY.md. How termcard handles personal data is described in PRIVACY.md.

Designed and built by Ahmet Erkan Paşahan · LinkedIn · GitHub · try it: npx aepasahan

Released under the MIT License.

Frequently asked questions

What is termcard?

Create terminal business cards (npx <name>) in a chat, or look up anyone's card.

How do I install termcard?

It runs as a remote server. In Claude Code: claude mcp add --transport http termcard 'https://mcp.termcard.dev/mcp'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does termcard need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is termcard open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains termcard?

It is published by aepasahan. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.