Skip to main content
PDF4me APIIntegrationsKnowledge BaseExtensionsAPI TesterBlog

PDF4me MCP Getting Started

The PDF4me MCP Server lets AI assistants call PDF4me APIs through the Model Context Protocol (MCP), so teams can automate PDF and document workflows directly from MCP-enabled clients.

Prerequisites​

  • A PDF4me account and API key
  • UV installed (required for uvx)
  • Any MCP client such as Cursor, VS Code, Claude Desktop, Windsurf, or Continue
Get your API KeyView GitHub Repository

Install UV​

uvx runs the MCP server package without a manual global install.

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

Configure PDF4me MCP in Your Client​

Use the same server command in all clients: uvx pdf4me-mcp.
Set your environment variable API_KEY to your PDF4me API key.

Cursor​

Edit ~/.cursor/mcp.json (macOS/Linux) or %USERPROFILE%\\.cursor\\mcp.json (Windows):

{
  "mcpServers": {
    "pdf4me-mcp": {
      "command": "uvx",
      "args": ["pdf4me-mcp"],
      "env": {
        "API_KEY": "your-api-key-here"
      }
    }
  }
}

VS Code​

Edit ~/.config/Code/User/mcp.json (macOS/Linux) or %APPDATA%\\Code\\User\\mcp.json (Windows):

{
  "servers": {
    "pdf4me-mcp-std": {
      "type": "stdio",
      "command": "uvx",
      "args": ["pdf4me-mcp"],
      "env": {
        "API_KEY": "your-api-key-here"
      }
    }
  }
}

Claude Desktop​

Edit:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\\Claude\\claude_desktop_config.json
  • Linux: ~/.config/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "pdf4me-mcp": {
      "command": "uvx",
      "args": ["pdf4me-mcp"],
      "env": {
        "API_KEY": "your-api-key-here"
      }
    }
  }
}

Windsurf​

Edit ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "pdf4me-mcp": {
      "command": "uvx",
      "args": ["pdf4me-mcp"],
      "env": {
        "API_KEY": "your-api-key-here"
      }
    }
  }
}

Continue (VS Code / JetBrains)​

Edit ~/.continue/config.json:

{
  "mcpServers": [
    {
      "name": "pdf4me-mcp",
      "command": "uvx",
      "args": ["pdf4me-mcp"],
      "env": {
        "API_KEY": "your-api-key-here"
      }
    }
  ]
}

Windows Note​

If uvx is not available on your PATH, use the full executable path:

"command": "C:\\Users\\<YourUser>\\.local\\bin\\uvx"

Manual Run (without client)​

uvx pdf4me-mcp

Or, if installed locally:

API_KEY=your-api-key-here pdf4me-mcp

Next Step​

After configuration, open your MCP client, verify the pdf4me-mcp server is running, and trigger your first PDF action from the assistant.