# notecardHQ

> notecardHQ is a paid MCP server for communication. Send real handwritten, mailed cards from an agent or API, priced per card. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Paid
- **Platforms:** API, Web
- **Website:** https://notecardhq.com/developers
- **MCP Registry name:** com.notecardhq/notecardhq
- **Categories:** communication, marketing and SEO
- **Listing updated:** 2026-11-15

## About

Each card is written by a robot holding a real pen, stamped and posted, and the sender reads its status as created, written or mailed. The MCP server exposes two tools, send_note and get_note, and connects with the team's API key, which picks the workspace. Agents pass through the same validation, idempotency keys and address checks as direct API calls.

A message is limited to 500 characters. An Idempotency-Key header means a retry with the same body returns the same note, while a changed body under an old key is refused. US addresses are verified and standardised, and an undeliverable one is rejected with nothing created. Test keys apply identical validation but never write, mail or bill, and move notes through printed and mailed a minute apart so handlers can be tested. Webhooks are signed with HMAC-SHA256 and retried for about two days.

The developer page shows integrations with Zapier, Stripe, Shopify, HubSpot, Salesforce, n8n and Make. Pricing is per mailed card with postage included and no monthly fee. It starts at $3.25 per card at 100 cards a month, and cancelled notes are not billed.

## Features

- **Two-tool MCP server:** send_note creates a card and get_note reads its status.
- **Idempotent sending:** The same Idempotency-Key and body return the same note, so retries never send twice.
- **US address verification:** Addresses are checked and standardised, and undeliverable ones are rejected.
- **Test keys:** Same validation as live keys, with nothing written, mailed or billed.
- **Signed webhooks:** Every status change fires an HMAC-SHA256 signed event, retried for about two days.
- **All-in per-card pricing:** Card, handwriting, envelope and postage are included in one price.

## Good for

- Send a thank-you card after a first sale
- Mail a note to a customer when a deal closes
- Let an agent follow up with a handwritten card
- Trigger cards from Shopify or Stripe events

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http notecardhq https://app.notecardhq.com/api/mcp
```

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

```sh
https://app.notecardhq.com/api/mcp
```

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

```json
{
  "mcpServers": {
    "notecardhq": {
      "url": "https://app.notecardhq.com/api/mcp"
    }
  }
}
```

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

```json
{
  "servers": {
    "notecardhq": {
      "type": "http",
      "url": "https://app.notecardhq.com/api/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "notecardhq": {
      "serverUrl": "https://app.notecardhq.com/api/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "notecardhq": {
      "type": "http",
      "url": "https://app.notecardhq.com/api/mcp"
    }
  }
}
```

## Tools

- `send_note`: Creates a handwritten card to be written and mailed.
- `get_note`: Reads a note's status.

## FAQ

### How long can a message be?

Up to 500 characters.

### Is postage included in the price?

Yes. Prices include the card, handwriting, envelope and postage.

### Can I test without sending cards?

Yes. Test keys use the same validation but never write, mail or bill.

### Do I pay for cancelled notes?

No. A card bills when it is mailed, and notes cancelled before writing are not billed.

### Is notecardHQ free?

No. notecardHQ is a paid product.

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

Run this command in your terminal: claude mcp add --transport http notecardhq https://app.notecardhq.com/api/mcp

### What are the best alternatives to notecardHQ?

The closest alternatives to notecardHQ are Google Ads + Meta Ads + SEO/GEO MCP, Calven, MCP, BoardAgent and Callout.

## Alternatives

- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [Calven](https://ai-powered.com/mcp/calven): Calven is an MCP server for marketing and seo.
- [MCP](https://ai-powered.com/mcp/mcp-mwhffe53): MCP is a freemium MCP server for marketing and seo.
- [BoardAgent](https://ai-powered.com/mcp/boardagent): BoardAgent is a free MCP server for community directories.
- [Callout](https://ai-powered.com/mcp/callout): Callout is a freemium MCP server for communication.
- [Red Center Studio free tools](https://ai-powered.com/mcp/red-center-studio-free-tools): Red Center Studio free tools is a free MCP server for marketing and seo.
- [nicemails](https://ai-powered.com/mcp/nicemails): nicemails is a freemium MCP server for communication.
- [SOMMON Office](https://ai-powered.com/mcp/sommon-office): SOMMON Office is a paid MCP server for communication.

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