Labradoc MCP Server

Labradoc MCP Server

A Model Context Protocol (MCP) server that exposes Labradoc API capabilities as MCP tools. This enables AI assistants like Claude Desktop, OpenAI Agents, and other MCP-compatible clients to interact with Labradoc's document management, email ingestion, task extraction, and integration features.

Features

• Files: List, search, get, and archive documents
• Email: Manage inbound email addresses and view ingested emails
• Tasks: List and close tasks extracted from documents
• User: View usage statistics and purchase AI credits
• Integrations: Connect Google Drive, Gmail, and Microsoft Outlook

Requirements

• Node.js 20+
• A Labradoc API key

Quick Start

npx @labradoc/mcp

Or install globally:

npm install -g @labradoc/mcp
LABRADOC_API_KEY=your-key labradoc-mcp

Configuration

| Variable | Required | Default | Description | |----------|----------|---------|-------------| | LABRADOC_API_KEY | Yes | - | Your Labradoc API key | | LABRADOC_API_URL | No | https://labradoc.eu | Labradoc API base URL | | LABRADOC_LOG_LEVEL | No | info | Log level: debug, info, warn, error |

Available MCP Tools

Files

| Tool | Description | |------|-------------| | files_list | List user's files with optional status filter, pagination, and search | | files_search | Search files by query string | | files_get | Get a single file by ID | | files_delete | Archive files by their IDs |

Email

| Tool | Description | |------|-------------| | email_addresses_list | List user's inbound email addresses | | email_addresses_create | Request a new inbound email address | | emails_list | List ingested emails |

Tasks

| Tool | Description | |------|-------------| | tasks_list | List tasks extracted from documents | | tasks_close | Close/complete tasks by their IDs |

User & Billing

| Tool | Description | |------|-------------| | user_stats | Get user statistics (completed pages, unlimited pages status) | | billing_checkout | Create a Stripe checkout session for AI credits |

Integrations

| Tool | Description | |------|-------------| | google_drive_status | Check if Google Drive is connected | | google_drive_connect | Start Google Drive OAuth flow | | google_gmail_status | Check if Gmail is connected | | google_gmail_connect | Start Gmail OAuth flow | | microsoft_outlook_status | Check if Microsoft Outlook is connected | | microsoft_outlook_connect | Start Microsoft Outlook OAuth flow |

Usage

Claude Desktop (macOS/Windows)

Edit your Claude Desktop configuration file:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "labradoc": {
      "command": "npx",
      "args": ["@labradoc/mcp"]
    }
  }
}

Or with a global install:

{
  "mcpServers": {
    "labradoc": {
      "command": "labradoc-mcp"
    }
  }
}

Set the API key in your environment or .env file: `` LABRADOC_API_KEY=your-api-key ``

Claude CLI

claude mcp add labradoc -- npx @labradoc/mcp

Direct stdio Usage

LABRADOC_API_KEY=your-key npx @labradoc/mcp

Development

npm install
npm run build
LABRADOC_API_KEY=your-key node dist/index.js

License

MIT