Log inSubmit server
Dropscan MCP logo

Dropscan MCP

Connects MCP clients to Dropscan for reading scanned mail, downloading assets, and optionally managing mail actions and webhooks.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Dropscan MCP

Pick your client, then add it in one click or paste the config.

STDIOPython
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "dropscan-mcp": {
      "command": "uvx",
      "args": [
        "dropscan-mcp"
      ],
      "env": {
        "DROPSCAN_TOKEN": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

We couldn’t confirm it starts correctly

We ran the install command but it didn't respond within our test window — this can mean a slow first-time install rather than a real problem.

uvx dropscan-mcp

No response to initialize.

This is an experimental automated check and can have false negatives — missing environment variables, a slow cold install, etc. It doesn’t necessarily mean something’s wrong. Last checked 12d ago.

Overview

The dropscan-mcp MCP server connects MCP clients to the Dropscan postal-mail-to-email API over stdio. It exposes read-only tools for scanboxes, mailings, recipients, shipments, forwarding addresses, webhook rules, and downloadable PDF, ZIP, envelope, and OCR assets. Optional write tools can request scans, forwarding, or destruction and manage related records, but require both an environment flag and per-call confirmation. Use it when an agent needs to inspect a Dropscan account or perform explicitly authorized mail-management operations.

Use cases

  • List scanboxes and recent mailings
  • Download mailing scans and OCR text
  • Inspect recipients, shipments, and webhook rules
  • Request or cancel authorized mailing actions
  • Manage Dropscan forwarding addresses and webhook rules

Key features

  • Read Dropscan scanboxes and mailings
  • Download PDF, ZIP, envelope, and OCR assets
  • Inspect recipients, shipments, and webhooks
  • Double-gated mailing actions and writes
  • Create and manage recipients, addresses, and webhook rules
  • stdio transport with Bearer-token authentication

Tools1

What Dropscan MCP lets your agent do. Expand a tool for its parameters.

Self-reported~7 tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked Today

Recent health check succeeded.

7/7 checks healthy over the last 58d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 12d ago via OSV.dev · dropscan-mcp (PyPI)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars1Stargazers on the source repository.
Last commit16d agoMost recent push to the default branch.
Install checkInconclusiveDidn't respond in our test window — often a slow first install.
Tools exposed1Callable tools this server registers over MCP.
Directory activity1 viewsConfig copies, upvotes, and views on AllMCPs.

How Dropscan MCP works

What dropscan-mcp does

The dropscan-mcp MCP server gives an MCP client access to a Dropscan account, where physical letters are received through scanboxes. It supports account inspection, mailing retrieval, file downloads, and selected account-management operations through the Dropscan API.

Read-only access includes listing scanboxes and mailings, filtering mailings by status or age, and retrieving an individual mailing. Agents can also request a mailing as a PDF, ZIP archive, envelope image, or OCR plaintext. Downloaded binary assets are written to disk and the tool reports the resulting path, byte size, and content type.

The server also exposes read access to recipients, forwarding addresses, shipments, and webhook rules. With writes enabled, an agent can request or cancel a mailing action, assign a recipient, create recipients and forwarding addresses, and create, update, or delete webhook rules.

How it works

The dropscan-mcp MCP server runs over stdio and sends HTTP requests to Dropscan using a personal access token. The token comes from DROPSCAN_TOKEN and is sent as a Bearer authorization header; it is not embedded in the application.

All read operations remain available without an additional switch. Operations that change state are protected by two checks. DROPSCAN_ALLOW_WRITES must be set to 1, true, or yes, and the individual tool call must include confirm: true. The write flag is disabled unless explicitly configured.

This protection matters because the server talks to a production Dropscan account. A forward operation physically mails a letter and can incur a charge. A destroy operation permanently shreds the letter. For forwarding, the request also needs a forwarding address ID and a forwarding date in ISO YYYY-MM-DD format.

Setup and configuration

Install the package from a local clone with Python 3.10 or newer:

bash
python3 -m venv .venv
./.venv/bin/pip install .

Provide a Dropscan personal access token in DROPSCAN_TOKEN. The server can be registered with Claude Code using its MCP command, or configured in Claude Desktop with a command that runs the package's Python module. The process uses stdio, so the client must launch the server locally.

Leave DROPSCAN_ALLOW_WRITES unset for read-only operation. Set it to an accepted true value only when action and management tools are needed. Download tools use ~/Downloads by default; set DROPSCAN_DOWNLOAD_DIR or pass save_path to choose another location.

Tools and capabilities

Read-only tools cover:

  • Scanbox and mailing discovery, including mailing status and age filters.
  • Mailing metadata and downloads in PDF, ZIP, envelope-image, and plaintext formats.
  • Recipient, forwarding-address, shipment, and webhook-rule lookup.

Write and action tools cover scan, forward, and destroy requests; action cancellation; mailing-recipient assignment; recipient and forwarding-address creation; and webhook-rule creation, editing, and deletion. Webhook subscriptions can use the documented Dropscan event names, including mailing, shipment, and package-tracking events.

The dropscan-mcp MCP server requires a valid Dropscan personal access token and does not provide a sandbox for testing destructive operations. Use the read-only mode when an agent only needs to inspect mail or retrieve scans.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Dropscan MCP

dropscan-mcp is an MCP server that connects MCP clients to the Dropscan postal-mail-to-email API. Its main tools list scanboxes and mailings, retrieve mailing details and scan assets, and manage recipients, forwarding addresses, webhook rules, and mailing actions when write safeguards are enabled.

Install it from a local clone with Python 3.10 or newer by creating a virtual environment and running `./.venv/bin/pip install .`. Then configure the MCP client to launch the installed server over stdio.

Set the required `DROPSCAN_TOKEN` environment variable to a Dropscan personal access token. The server sends it as a Bearer token when calling the Dropscan API and does not hardcode it.

Set `DROPSCAN_ALLOW_WRITES` to `1`, `true`, or `yes`, and pass `confirm: true` to each write or action tool. Both conditions are required; writes remain disabled by default.

The server runs over stdio; Claude Code can launch the `dropscan-mcp` command, while Claude Desktop can run the module with the configured Python executable.

Related MCP servers

All in Delivery All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewDropscan MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/dropscan-mcp?style=directory)](https://allmcps.com/mcp/dropscan-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/dropscan-mcp"><img src="https://allmcps.com/api/badge/dropscan-mcp?style=directory" alt="Dropscan MCP on AllMCPs" /></a>