Gemini Ocr MCP Server

This project provides a simple yet powerful OCR (Optical Character Recognition) service through a FastMCP server, leveraging the capabilities of the

Local serverstdioPython

What is the Gemini Ocr MCP Server?

Gemini Ocr MCP becomes available to MCP clients through the Gemini Ocr MCP. This project provides a simple yet powerful OCR (Optical Character Recognition) service through a FastMCP server, leveraging the capabilities of the Google Gemini API. It allows you to extract text from images either by providing a file path or a base64 encoded string.

What Gemini Ocr MCP does

This project provides a simple yet powerful OCR (Optical Character Recognition) service through a FastMCP server, leveraging the capabilities of the Google Gemini API. It allows you to extract text from images either by providing a file path or a base64 encoded string.

Key capabilities

  • File-based OCR: — Extract text directly from an image file on your local system
  • Base64 OCR: — Extract text from a base64 encoded image string
  • Easy to Use: — Exposes OCR functionality as simple tools in an MCP server
  • Powered by Gemini: — Utilizes Google's advanced Gemini models for high-accuracy text recognition

Requirements

  • Python 3.8 or higher - A Google Gemini API Key. You can obtain one from Google AI Studio.

Practical notes

  • Maintained by WindoC, written in Python.

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
ocr_image_file
ocr_image_base64

How to install the Gemini Ocr MCP Server

{
  "mcpServers": {
    "gemini-ocr-mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "x:\\path\\to\\your\\project\\gemini-ocr-mcp",
        "run",
        "gemini-ocr-mcp.py"
      ],
      "env": {
        "GEMINI_MODEL": "gemini-2.5-flash-preview-05-20",
        "GEMINI_API_KEY": "YOUR_GEMINI_API_KEY"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

  • Python 3.8 or higher - A Google Gemini API Key. You can obtain one from Google AI Studio.
VariableDescriptionRequired
GEMINI_MODELDeclared in the maintainer’s client configuration.Check documentation
GEMINI_API_KEYDeclared in the maintainer’s client configuration.Check documentation

Example prompts to try

  • “Use Gemini Ocr MCP to ocr image file.”
  • “Use Gemini Ocr MCP to ocr image base64.”

Frequently asked questions

This project provides a simple yet powerful OCR (Optical Character Recognition) service through a FastMCP server, leveraging the capabilities of the Google Gemini Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.