ComIDP
A lightweight MCP (Model Context Protocol) server designed for seamless integrating ComIDP with Claude Desktop.
What is ComIDP?
ComIDP is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to lightweight mcp (model context protocol) server designed for seamless integrating comidp with claude desktop.
A lightweight MCP (Model Context Protocol) server designed for seamless integrating ComIDP with Claude Desktop.
This server falls under the File Systems category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- A lightweight MCP (Model Context Protocol) server designed f
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx comidp-mcp-serverConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use ComIDP
ComIDP MCP Server integrates ComPDF AI's Intelligent Document Processing (IDP) service with Claude Desktop, enabling AI-assisted extraction of structured data from PDFs and common image formats including PNG, JPG, and TIFF. It exposes two tools — one for processing individual documents and one for batch-processing entire directories — turning unstructured invoices, contracts, and forms into machine-readable structured output. Teams use it to automate document parsing workflows directly from Claude conversations without writing custom extraction pipelines.
Prerequisites
- Python 3.10 or higher
- pip and the uv package manager
- A ComPDF AI API key (IDPKEY) — available via the ComPDF free trial program at compdf.com
- An MCP client such as Claude Desktop
Clone the repository
Clone the ComPDFKit/ComIDP-MCP-Server repository and navigate to the src directory where the server code lives.
git clone https://github.com/ComPDFKit/ComIDP-MCP-Server.git
cd ComIDP-MCP-Server/srcCreate a Python virtual environment
Create and activate a virtual environment to isolate the server's dependencies from your system Python.
python -m venv .venv
# macOS/Linux:
source .venv/bin/activate
# Windows:
.venv\Scripts\activateInstall dependencies
Install all required Python packages from the requirements file.
pip install -r requirements.txtObtain a ComPDF AI API key
Sign up at compdf.com and retrieve your IDPKEY from the developer dashboard. This key authenticates all document processing API calls.
Configure Claude Desktop
Add the server to claude_desktop_config.json. Use absolute paths for the directory and script arguments. Replace /path/to/src with the real absolute path to the cloned src directory.
Restart Claude Desktop and test
Restart Claude Desktop so it loads the new server. Then ask Claude to extract data from a PDF file to verify the connection.
ComIDP Examples
Client configuration
Add this block to claude_desktop_config.json. Replace /absolute/path/to/ComIDP-MCP-Server/src with the actual path on your machine.
{
"mcpServers": {
"comidp-mcp": {
"command": "uv",
"args": [
"run",
"--directory",
"/absolute/path/to/ComIDP-MCP-Server/src",
"/absolute/path/to/ComIDP-MCP-Server/src/comidp_tools.py"
],
"env": {
"IDPKEY": "your_compdf_api_key_here"
}
}
}
}Prompts to try
Once the server is connected, use these prompts in Claude Desktop to extract data from documents.
- "Extract all data from /documents/invoice.pdf and summarize the key fields."
- "Process all PDFs in /documents/invoices/ and extract invoice numbers, vendors, and totals."
- "Extract the table data from /reports/financial_statement.pdf."
- "Read /scans/contract.pdf and identify the parties, dates, and payment terms."Troubleshooting ComIDP
Server fails with 'IDPKEY not set' or authentication errors
Ensure the IDPKEY environment variable is set in the env block of your claude_desktop_config.json. The key is passed at runtime and is not read from .env files automatically.
Claude Desktop cannot find the server script
Use absolute paths in both the --directory argument and the script path argument. Relative paths are not resolved by Claude Desktop's MCP server launcher.
Batch extraction from a folder returns no results
Confirm the directory path is accessible to the Python process and contains supported file types (PDF, PNG, JPG, TIFF). Use the data_extraction tool on a single file first to confirm API connectivity before trying batch mode.
Frequently Asked Questions about ComIDP
What is ComIDP?
ComIDP is a Model Context Protocol (MCP) server that lightweight mcp (model context protocol) server designed for seamless integrating comidp with claude desktop. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install ComIDP?
Follow the installation instructions on the ComIDP GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with ComIDP?
ComIDP works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is ComIDP free to use?
Yes, ComIDP is open source and available under the Apache-2.0 license. You can use it freely in both personal and commercial projects.
ComIDP Alternatives — Similar File Systems Servers
Looking for alternatives to ComIDP? Here are other popular file systems servers you can use with Claude, Cursor, and VS Code.
Electerm
★ 14.1k📻Terminal/ssh/sftp/ftp/telnet/serialport/RDP/VNC/Spice client(linux, mac, win)
Plik
★ 1.8kPlik is a temporary file upload system (Wetransfer like) in Go.
Kordoc
★ 957An MCP server that parses South Korean document formats like HWP, HWPX, and PDF into Markdown. It features specialized table reconstruction and security-hardened extraction optimized for administrative and public institution files.
macOS Automator
★ 801A Model Context Protocol server that enables execution of AppleScript and JavaScript for Automation scripts on macOS, allowing programmatic control of applications and system functions through a rich knowledge base of pre-defined scripts.
PDF Reader
★ 723Enables reading, searching, and metadata extraction from PDF files without loading the entire content into the context window. It provides efficient tools for text cleaning, page-specific extraction, and context-aware search results.
Filesystem MCP Server
★ 643Provides comprehensive filesystem operations (read, write, list, create, delete, move files and directories) through the Model Context Protocol with Streamable HTTP transport and built-in security through configurable root directory restrictions.
Browse More File Systems MCP Servers
Explore all file systems servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up ComIDP in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use ComIDP?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.