Metadata-Version: 2.5
Name: omnidesk-mcp
Version: 0.1.0
Summary: OmniDesk MCP server — let AI agents convert files across 325 formats
Project-URL: Homepage, https://omnidesk.win
Project-URL: Documentation, https://omnidesk.win/en/api/
Author-email: Projectteamforyou <projectteamforyou@gmail.com>
License: MIT
Requires-Python: >=3.10
Requires-Dist: httpx>=0.27
Requires-Dist: mcp>=2.0
Description-Content-Type: text/markdown

# omnidesk-mcp

An MCP server that lets Claude, Cursor and other agents convert files through
[OmniDesk](https://omnidesk.win) — 325 formats, routed through intermediate
formats when no direct converter exists.

## Setup

You need an OmniDesk API key (Team plan). Create one at
**app.omnidesk.win → Control panel → API keys**.

Add to your MCP client config (Claude Desktop: `claude_desktop_config.json`):

```json
{
  "mcpServers": {
    "omnidesk": {
      "command": "uvx",
      "args": ["omnidesk-mcp"],
      "env": { "OMNIDESK_API_KEY": "od_..." }
    }
  }
}
```

## Tools

| tool | what it does |
|---|---|
| `convert_file` | convert a local file to another format; returns the result path |
| `list_formats` | the 325 supported formats by category |
| `find_route` | how a conversion would be routed, and alternatives |
| `file_action` | one of 33 file actions: extract tables, redact, OCR, trim, … |
| `list_actions` | the actions and their options |

Files are uploaded to your company drive, converted there, and the result is
downloaded back to a path you choose. Nothing is kept on the client beyond that.
