Labradoc 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