Skip to main content

Overview

Retab exposes its workflow and document tools through an MCP server, so you can build and run document pipelines directly from an MCP-compatible client. Use these connection settings across clients:
SettingValue
Server nameretab
Transportstreamable-http
Server URLhttps://mcp.retab.com/mcp
AuthenticationOAuth or Api-Key header, depending on the client

Before You Start

Make sure you have:
  1. A Retab account
  2. A Retab API key from Settings > API Keys
  3. A supported MCP client such as Claude Code, Claude Desktop, Codex, or another MCP-compatible app
Store your API key securely. It may only be shown once when created.

Claude Code

Run this command in your terminal:
claude mcp add --transport http retab https://mcp.retab.com/mcp --header "Api-Key: YOUR_API_KEY"
Replace YOUR_API_KEY with your Retab API key.

Claude Desktop

A paid Claude subscription is required to connect MCP servers in Claude Desktop.
  1. Open Settings
  2. Go to Connectors
  3. Click Add custom connector
  4. Set the server name to retab
  5. Set the server URL to https://mcp.retab.com/mcp
  6. Complete the authentication flow when Claude redirects you to it
If the authentication screen asks for a key, use your Retab API key.

Codex

Run this command in your terminal:
codex mcp add retab --url https://mcp.retab.com/mcp
Then:
  1. Codex opens an OAuth consent URL in your browser
  2. Complete the authorization flow for your Retab account
  3. Verify that the server is connected:
codex mcp get retab
Codex CLI and the IDE extension share the same MCP configuration, so once you add the server, it is available in both. If the OAuth flow asks for a key, use your Retab API key.

Generic MCP Clients

If your client supports manual MCP configuration, use:
SettingValue
Server Nameretab
TransportStreamable HTTP
URLhttps://mcp.retab.com/mcp
Auth HeaderApi-Key: YOUR_API_KEY
Example configuration:
{
  "retab": {
    "type": "streamable-http",
    "url": "https://mcp.retab.com/mcp",
    "headers": {
      "Api-Key": "YOUR_API_KEY"
    }
  }
}

After Installation

Once the MCP server is connected, you can ask your client to:
  1. Browse your Retab files or collections
  2. Build a workflow from sample documents
  3. Run the workflow and iterate on the extraction results
For the workflow model itself, see Workflows and Node Reference.