docu-suite-mcp

MCP server for ilovepdfdoc.com. It lets Claude Desktop, Cursor, Zed, Windsurf, Continue, and other MCP-compatible clients use Docu Suite's document conversion and AI text enhancement tools from a local MCP connection.

What it does

• Converts local files through the Docu Suite API and downloads completed outputs to your machine
• Enhances text with AI instructions such as clarity, grammar, concise, professional, or custom prompts
• Tracks job progress with polling helpers and result download support
• Works with common MCP clients over stdio using a simple npx launch command

Available MCP tools

| Tool | Purpose | | --- | --- | | convert_document | Upload one or more local files, run a supported document operation, poll until completion, and save the output locally | | enhance_text | Improve text with an instruction or preset | | get_job_status | Fetch the current state of a previously created job | | download_result | Download the result of a completed job | | list_jobs | Return the most recent jobs from the Docu Suite API |

Supported document operations

• pdf-to-word
• pdf-to-excel
• pdf-to-markdown
• pdf-compress
• pdf-merge
• pdf-split
• pdf-lock
• pdf-unlock
• image-to-pdf
• jpg-to-pdf
• magic-ocr
• markdown-to-pdf
• markdown-to-docx
• docx-to-markdown

Installation

The recommended runtime command is:

npx -y docu-suite-mcp

That is the command MCP clients should use in their config.

If you instead run:

npm i docu-suite-mcp

that installs the package into the current project only. It does not automatically register the MCP server with Claude, Cursor, or any other client.

Configuration

The server supports these environment variables:

| Variable | Default | Description | | --- | --- | --- | | DOCU_SUITE_URL | http://localhost:3000 | Base URL for the Docu Suite app or deployed API | | OUTPUT_DIR | system temp directory | Folder where completed files are downloaded locally |

Example environment block:

{
  "DOCU_SUITE_URL": "https://ilovepdfdoc.com",
  "OUTPUT_DIR": "/Users/yourname/Downloads"
}

Client setup

The config payload is the same across clients. Only the file location changes.

Claude Desktop

Config file:

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

{
  "mcpServers": {
    "docu-suite": {
      "command": "npx",
      "args": ["-y", "docu-suite-mcp"],
      "env": {
        "DOCU_SUITE_URL": "https://ilovepdfdoc.com",
        "OUTPUT_DIR": "/Users/yourname/Downloads"
      }
    }
  }
}

Restart Claude Desktop after saving the config.

Cursor

Add this to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "docu-suite": {
      "command": "npx",
      "args": ["-y", "docu-suite-mcp"],
      "env": {
        "DOCU_SUITE_URL": "https://ilovepdfdoc.com",
        "OUTPUT_DIR": "/Users/yourname/Downloads"
      }
    }
  }
}

Zed

Add this under context_servers in Zed settings:

{
  "context_servers": {
    "docu-suite": {
      "command": {
        "path": "npx",
        "args": ["-y", "docu-suite-mcp"],
        "env": {
          "DOCU_SUITE_URL": "https://ilovepdfdoc.com",
          "OUTPUT_DIR": "/Users/yourname/Downloads"
        }
      }
    }
  }
}

Windsurf

Add this to ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "docu-suite": {
      "command": "npx",
      "args": ["-y", "docu-suite-mcp"],
      "env": {
        "DOCU_SUITE_URL": "https://ilovepdfdoc.com",
        "OUTPUT_DIR": "/Users/yourname/Downloads"
      }
    }
  }
}

Continue

Add this to your Continue config under mcpServers:

{
  "mcpServers": [
    {
      "name": "docu-suite",
      "command": "npx",
      "args": ["-y", "docu-suite-mcp"],
      "env": {
        "DOCU_SUITE_URL": "https://ilovepdfdoc.com",
        "OUTPUT_DIR": "/Users/yourname/Downloads"
      }
    }
  ]
}

Local development

From the mcp-server directory:

npm install
npm run build
npm run dev

Package scripts:

| Script | Description | | --- | --- | | npm run build | Compile TypeScript to dist/ | | npm run dev | Run the server with ts-node | | npm run start | Run the built server from dist/index.js |

Notes

• The MCP server expects the Docu Suite web app API to be reachable at DOCU_SUITE_URL
• convert_document accepts absolute local file paths and tool-specific options
• Completed files are downloaded into OUTPUT_DIR
• Node.js 18+ is required

Changelog

1.0.3 - 2026-04-20

• Added clearer install guidance around npx -y docu-suite-mcp versus local npm i
• Expanded README setup docs for Claude Desktop, Cursor, Zed, Windsurf, and Continue
• Documented the supported conversion operations and MCP tool surface more clearly

1.0.2

• Added npm-ready packaging updates for docu-suite-mcp
• Improved MCP usage flow for direct client configuration

1.0.0

• Initial MCP server release with document conversion, job polling, downloads, and AI text enhancement

License

MIT