Skip to main content
Glama
README.md
# Paperless Post API and MCP server for ChatGPT and Claude

Paperless Post has no public API, webhooks or official MCP server according to the live Cotlet.dev page, checked 27 October 2026. Cotlet.dev connects ChatGPT, Claude and other AI agents to your own Paperless Post account through 11 hosted workflow tools for events, guests, RSVPs and messages. Sending invitations and messages asks for approval by default.

## What you can ask

> List my Paperless Post events and their send status.

> Prepare guests from a spreadsheet for an unsent invitation.

> Show which guests have replied and the current headcount.

> Draft an RSVP reminder for guests who have not replied, and ask before sending.

> Tag a guest group and draft a message for it.

> Export the guest list and RSVP status for the venue.

## Connect in 2 minutes

Get your API key at https://cotlet.dev/app and export it as `COTLET_API_KEY`.

### ChatGPT

Settings > Apps & Connectors > Create. Use `https://cotlet.dev/mcp/v1/connect` with OAuth.

### Claude

Settings > Connectors > Add custom connector. Use `https://cotlet.dev/mcp/v1/connect`.

### Claude Code

```bash
claude mcp add --transport http cotlet https://cotlet.dev/mcp/v1 --header "Authorization: Bearer $COTLET_API_KEY"
```

### Cursor

Copy `.cursor/mcp.json` from this repo into your project:

```json
{
  "mcpServers": {
    "cotlet": {
      "url": "https://cotlet.dev/mcp/v1",
      "headers": {
        "Authorization": "Bearer ${env:COTLET_API_KEY}"
      }
    }
  }
}
```

## Run it locally (stdio)

This repo is a real MCP server. It speaks MCP over stdio, lists its Paperless Post tools without any key, and forwards every tool call to the hosted Cotlet.dev server. The hosted URL above stays the recommended way. Use this when your client only starts local servers.

Clone this repository and run `python3 paperless_post_agent.py serve` with `COTLET_API_KEY` set.

Or with Docker:

```bash
docker build -t paperless-post-mcp .
docker run -i --rm -e COTLET_API_KEY paperless-post-mcp
```

The local server exposes seven browser helper tools, distinct from the 11 hosted workflow tools described on the live page.

Local tools: `paperless_post_guide`, `paperless_post_status`, `paperless_post_open`, `paperless_post_read`, `paperless_post_click`, `paperless_post_type`, `paperless_post_close`. Without `COTLET_API_KEY` a tool call answers: "Set COTLET_API_KEY. Get a key at https://cotlet.dev/app".

## Command line

Python 3.10+, nothing else to install. Run from this repo:

```bash
export COTLET_API_KEY="your-key"
python3 paperless_post_agent.py connect   # ready config for Claude Code, Cursor, ChatGPT
python3 paperless_post_agent.py status    # is Paperless Post ready in your Cotlet.dev account
python3 paperless_post_agent.py guide     # Paperless Post screens and sign-in link
python3 paperless_post_agent.py read      # open Paperless Post, read the page, close the browser
python3 paperless_post_agent.py tools     # list Cotlet.dev tools
python3 paperless_post_agent.py serve     # start the stdio MCP server (same as no argument)
```

## Questions from Paperless Post users

**How do I get access?**

Sign up at https://cotlet.dev/signup?app=paperless-post, open Paperless Post under Integrations and sign in to your own account in its Cotlet.dev Cloud Browser.

**Does Paperless Post have a public API or official MCP server?**

The live Cotlet.dev page reports no public API, webhooks or official MCP server, checked 27 October 2026. Cotlet.dev provides its own hosted MCP connection and API.

**Which actions ask for approval?**

Sending invitations, broadcast messages and private messages asks for approval by default. Adding guests to the unsent list and tagging guests reach nobody and run immediately. Approval settings can be changed per tool.

**Do Guest Tags work on every plan?**

Guest Tags require All Access pricing or Paperless Pro and are visible to hosts and co-hosts only.

**Can the agent edit invitation designs or buy Coins?**

No. You change the design and event details in Paperless Post yourself, and no tool buys Coins or changes billing.

**Is this an official Paperless Post integration?**

No. Cotlet.dev is independent and is not affiliated with, endorsed by or sponsored by Paperless Post.

## Live integration

[Paperless Post tools and connection guide](https://cotlet.dev/integrations/paperless-post-api-mcp-server?utm_source=github&utm_medium=readme&utm_campaign=paperless-post)

---

More: https://cotlet.dev/integrations/paperless-post-api-mcp-server?utm_source=github&utm_medium=readme&utm_campaign=paperless-post

Start free: https://cotlet.dev/signup?app=paperless-post&utm_source=github&utm_medium=readme&utm_campaign=paperless-post