A Model Context Protocol (MCP) server that enables Claude Desktop to analyze PDF documents using Google's AI models. This server sends PDF files & extracts text from PDFs by leveraging Gemini's powerful language understanding to provide intelligent analysis and insights.

1. Download: Get the pre-built JAR from Releases
2. API Key: Get your free Gemini API key from Google AI Studio
3. Configure: Add the server to your Claude Desktop config with the JAR path and API key
4. Analyze: Start analyzing PDFs with Claude!

• PDF Analysis: Extract and analyze PDF content using Gemini AI models
• Multiple Model Support: Choose from various Gemini models (2.5, 2.0, 1.5 series, and Gemma models)
• Dual Processing Methods: Direct PDF upload to Gemini or fallback text extraction
• MCP Integration: Seamless integration with Claude Desktop via Model Context Protocol
• Flexible Configuration: Environment-based configuration for easy deployment

• Java 11 or higher
• Maven (for building from source)
• Google AI Studio API Key (free at aistudio.google.com)
• Claude Desktop application
• Filesystem MCP Server (required dependency)

1. Download the latest CLDGeminiPDF.v1.0.0.jar from the Releases page
2. Save it to a convenient location on your system

git clone <your-repository-url>
cd CLDGeminiPDF
mvn clean compile assembly:single

This will create a JAR file with all dependencies included in the target/ directory.

1. Visit Google AI Studio
2. Sign in with your Google account
3. Click "Get API Key" and create a new key
4. Copy the API key for use in environment variables

The configuration file location depends on your operating system:

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

Add both the filesystem server and CLDGeminiPDF server to your claude_desktop_config.json:

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/path/to/your/documents"
      ]
    },
    "CLDGeminiPDF": {
      "command": "java",
      "args": [
        "-jar",
        "/path/to/CLDGeminiPDF.v1.0.0.jar"
      ],
      "env": {
        "GEMINI_API_KEY": "your_api_key_here",
        "GEMINI_MODEL": "gemini-2.0-flash"
      }
    }
  }
}

Important:

• Replace /path/to/your/documents with the directory containing your PDF files
• Replace /path/to/CLDGeminiPDF.v1.0.0.jar with the actual path to your downloaded JAR file
• Replace your_api_key_here with your actual Gemini API key

• Windows: "C:\\Users\\YourName\\Downloads\\CLDGeminiPDF.v1.0.0.jar"
• macOS: "/Users/YourName/Downloads/CLDGeminiPDF.v1.0.0.jar"
• Linux: "/home/yourusername/Downloads/CLDGeminiPDF.v1.0.0.jar"

Close and restart Claude Desktop for the changes to take effect.

Data for Free Tier Users of Google API

Model availability depends on your API key and usage tier. Check your Google AI Studio account for available models.

Data sourced from https://ai.google.dev/gemini-api/docs/rate-limits#free-tier

The CLDGeminiPDF MCP server requires the Filesystem MCP server to access PDF files. It works with complete file paths or by finding files within the allowed directory scope.

Note: Version 1.0.0 does NOT support drag-and-drop files in the chat interface. Files must be accessible through the filesystem server.

Once configured, you can use these commands in Claude Desktop:

Please analyze this research paper: file:///Users/username/Documents/research_paper.pdf
Focus on the methodology and conclusions.

Find the "research_paper.pdf" file in the Documents directory and analyze it using Gemini.

What Gemini models are available for PDF analysis?

Analyze this contract using the gemini-2.5-pro model: file:///path/to/contract.pdf
Look for key terms and potential risks.

1. "GEMINI_API_KEY environment variable is not set!"

   • Ensure your API key is properly set in the Claude Desktop configuration
   • Restart Claude Desktop after updating the configuration

2. "PDF file not found or not readable"

   • Verify the file path is correct and within the filesystem server's allowed directory
   • Ensure the PDF file exists and is readable
   • Check file permissions

3. "Gemini API error: 401"

   • Verify your API key is correct and valid
   • Check if your API key has the necessary permissions in Google AI Studio

4. "Gemini API error: 429"

   • You've hit rate limits. Wait and try again
   • Consider using a model with higher rate limits (see table above)

5. Filesystem server not working

   • Ensure the filesystem MCP server is properly configured
   • Check that the directory path in the filesystem configuration is correct
   • Verify Claude Desktop has permission to access the specified directory

To enable detailed logging, you can modify the Java command in your configuration:

"args": [
  "-Djava.util.logging.level=INFO",
  "-jar",
  "/path/to/CLDGeminiPDF.v1.0.0.jar"
]

Test your setup by asking Claude Desktop:

List the available Gemini models

If successful, you should see a JSON response with available models and their capabilities.

git clone <your-repository-url>
cd CLDGeminiPDF
mvn clean compile assembly:single

The JAR file will be created in the target/ directory.

• Jackson (JSON processing)
• Apache PDFBox (PDF text extraction)
• MCP Java SDK (Model Context Protocol)
• Java HTTP Client (API communication)

Contributions are welcome! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.

This project is licensed under the MIT License - see the LICENSE file for details.

For issues and questions:

• Check the troubleshooting section above
• Review Claude Desktop MCP documentation
• Check Google AI Studio API documentation
• Open an issue on this repository