DocuPipe MCP server

Use DocuPipe from Claude Code, Codex, Cursor and other MCP clients. Ask your agent to "pull the line items out of these invoices" and it uploads the files, extracts the fields you named and saves the JSON, in one tool call per file.

Setup

1. Sign up and copy your API key from the Developers card on the Settings page.
2. Add the server to your client, replacing your-api-key. Node.js 18 or newer is required.

Claude Code

claude mcp add docupipe --scope user -e DOCUPIPE_API_KEY=your-api-key -- npx -y @docupipe/mcp

Codex

codex mcp add docupipe --env DOCUPIPE_API_KEY=your-api-key -- npx -y @docupipe/mcp

Cursor: open this link to install, then replace your-api-key in Cursor's MCP settings:

cursor://anysphere.cursor-deeplink/mcp/install?name=docupipe&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBkb2N1cGlwZS9tY3AiXSwiZW52Ijp7IkRPQ1VQSVBFX0FQSV9LRVkiOiJ5b3VyLWFwaS1rZXkifX0=

Or add it by hand. Cursor and other clients that use an mcp.json file:

{
  "mcpServers": {
    "docupipe": {
      "command": "npx",
      "args": ["-y", "@docupipe/mcp"],
      "env": { "DOCUPIPE_API_KEY": "your-api-key" }
    }
  }
}

Then ask, for example:

Use DocuPipe to extract the invoice number, date, vendor and line items from every PDF in ./invoices and save one JSON file per invoice.

Tools

Tool	What it does
extract	File or URL in, structured JSON out: uploads, extracts with a saved schema, an inline JSON Schema or a schema DocuPipe drafts, waits, and can save the result
upload_document	Upload a local file or URL and wait for it to be read
get_document	Status, page count and parsed text of a document
standardize	Extract from an already uploaded document
get_standardization	Fetch an extraction result
create_schema, list_schemas	Save a JSON Schema, or reuse one the account already has
list_classes, classify	Classify a document into the account's classes
split_document	Split a file into sub-documents, with AI choosing where each one starts
list_workflows, run_workflow	Run a saved workflow on a file
convert_to_excel, get_excel_conversion	Turn a document into an .xlsx workbook without a schema, and save it locally
get_job, wait_for_jobs	Check or wait on any job

Each call returns within about 45 seconds. When DocuPipe needs longer, the tool returns status: "processing" with every id created so far and the exact call to resume with. Resuming never uploads or extracts a second time.

Credits

Tools use credits from your DocuPipe account. Upload is 1 credit per page for PDF, image, Word and HTML files (CSV, Excel, JSON, text and XML are free to upload). Extraction is 2 credits per page at standard effort and 4 at high effort. See credits and billing for every operation.

Configuration

Variable
DOCUPIPE_API_KEY	Required. Your API key.
DOCUPIPE_BASE_URL	Optional. Overrides the API address. Defaults to https://app.docupipe.ai.

Relative file paths resolve against the directory the server was started in, which for most clients is your project folder. Local files up to 100 MB are supported; pass a URL for larger files. Results larger than about 40,000 characters are written to docupipe-results/ in that folder and the tool returns the path with a preview.

Links

• API documentation
• Using DocuPipe from coding agents without this server

License

MIT