# PixelLetter MCP server

> Sends physical letters, faxes, and electronic invoice signatures through the PixelLetter interface.

- Repository: https://github.com/bitterdev/pixelletter-mcp
- Page: https://hostedmcp.org/servers/bitterdev/pixelletter-mcp
- Transport: stdio
- Stars: 0
- License: MIT
- Latest version: 1.0.3

## Install

### Claude Code

```sh
claude mcp add --env 'PIXELLETTER_PASSWORD=<YOUR_PIXELLETTER_PASSWORD>' --env 'PIXELLETTER_EMAIL=<PIXELLETTER_EMAIL>' pixelletter-mcp -- npx -y pixelletter-mcp
```

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

```json
{
  "mcpServers": {
    "pixelletter-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "pixelletter-mcp"
      ],
      "env": {
        "PIXELLETTER_PASSWORD": "<YOUR_PIXELLETTER_PASSWORD>",
        "PIXELLETTER_EMAIL": "<PIXELLETTER_EMAIL>"
      }
    }
  }
}
```

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

```json
{
  "servers": {
    "pixelletter-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "pixelletter-mcp"
      ],
      "env": {
        "PIXELLETTER_PASSWORD": "<YOUR_PIXELLETTER_PASSWORD>",
        "PIXELLETTER_EMAIL": "<PIXELLETTER_EMAIL>"
      }
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"pixelletter-mcp","type":"stdio","command":"npx","args":["-y","pixelletter-mcp"],"env":{"PIXELLETTER_PASSWORD":"<YOUR_PIXELLETTER_PASSWORD>","PIXELLETTER_EMAIL":"<PIXELLETTER_EMAIL>"}}'
```

### Claude Desktop (`claude_desktop_config.json`)

```json
{
  "mcpServers": {
    "pixelletter-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "pixelletter-mcp"
      ],
      "env": {
        "PIXELLETTER_PASSWORD": "<YOUR_PIXELLETTER_PASSWORD>",
        "PIXELLETTER_EMAIL": "<PIXELLETTER_EMAIL>"
      }
    }
  }
}
```

### Codex

```sh
codex mcp add pixelletter-mcp --env 'PIXELLETTER_PASSWORD=<YOUR_PIXELLETTER_PASSWORD>' --env 'PIXELLETTER_EMAIL=<PIXELLETTER_EMAIL>' -- npx -y pixelletter-mcp
```

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.pixelletter-mcp]
command = "npx"
args = ["-y", "pixelletter-mcp"]

[mcp_servers.pixelletter-mcp.env]
PIXELLETTER_PASSWORD = "<YOUR_PIXELLETTER_PASSWORD>"
PIXELLETTER_EMAIL = "<PIXELLETTER_EMAIL>"
```

### Gemini CLI

```sh
gemini mcp add -s user -e 'PIXELLETTER_PASSWORD=<YOUR_PIXELLETTER_PASSWORD>' -e 'PIXELLETTER_EMAIL=<PIXELLETTER_EMAIL>' pixelletter-mcp npx -- -y pixelletter-mcp
```

### Gemini settings.json (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "pixelletter-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "pixelletter-mcp"
      ],
      "env": {
        "PIXELLETTER_PASSWORD": "<YOUR_PIXELLETTER_PASSWORD>",
        "PIXELLETTER_EMAIL": "<PIXELLETTER_EMAIL>"
      }
    }
  }
}
```

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `PIXELLETTER_PASSWORD` | yes | yes | PixelLetter account password |
| `PIXELLETTER_EMAIL` | yes | no | E-mail address the PixelLetter account is registered with |
| `PIXELLETTER_DEFAULT_DESTINATION` | no | no | Default destination country as a two letter ISO code, for example DE |
| `PIXELLETTER_FORCE_TEST_MODE` | no | no | Force test mode for every order, so nothing is printed, sent or charged |

## Tools (6)

- `send_letter`: Sends a letter through PixelLetter, either as ready made documents (absolute file paths, PDF preferred) or as plain text plus a recipient address that PixelLetter typesets. Optionally faxes the same document as well. Returns the result code and the transaction id.
- `send_fax`: Sends documents or plain text as a fax through PixelLetter, without posting a letter. Additional services such as registered mail do not apply to faxes.
- `get_account_info`: Reads the stored customer data and the current credit of the PixelLetter account. Use it before sending to make sure the balance covers the order, error 021 means the credit is too low.
- `cancel_order`: Cancels a submitted order by its PixelLetter order id, which is on the order confirmation e-mail. Only works while the order has not been printed yet, otherwise PixelLetter answers with error 055.
- `sign_invoice`: Sends documents to the PixelLetter invoice signing service (action 4) and optionally mails the signed PDF to the invoice recipient. The account needs electronic signatures enabled once in the customer area, otherwise PixelLetter answers with error 046.
- `get_interface_reference`: Returns what the PixelLetter interface documents: action values, dispatch centres, additional service codes, allowed upload types, limits and the published error codes. Offline lookup, no API call.

## FAQ

### How can I test my orders without being charged?

You can use the testMode flag or set the PIXELLETTER_FORCE_TEST_MODE environment variable to true to run orders without printing or charging.

### Can I send a letter and a fax at the same time?

Yes, the send_letter tool can optionally send the document as a fax as well.

### How do I check my current account balance?

You can use the get_account_info tool to read your current credit and customer data.
