mcpField
P
Patent Downloader

Patent Downloader

Local
github.com/Edison-A-NLegal & Government6Updated 30w ago
Repository

About Patent Downloader

Patent Downloader is a Python SDK and CLI for retrieving patent PDFs and metadata from Google Patents. It also provides an MCP server and batch workflows for patent numbers supplied in TXT or CSV files.

Key features

  1. 01Download patent PDFs
  2. 02Retrieve patent metadata
  3. 03Batch downloads from TXT or CSV
  4. 04Python SDK and CLI

Use cases

  1. 01Save PDFs for selected patent numbers
  2. 02Inspect titles, inventors, and assignees
  3. 03Download patent lists from TXT or CSV files

MCP support

The MCP server exposes tools to download one or multiple patents and retrieve patent information. The default download directory can be set with the OUTPUT_DIR environment variable.

#patent-downloader#python-sdk#google-patents

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "patent_downloader": {
      "command": "uvx",
      "args": [
        "git+https://github.com/Edison-A-N/[email protected]"
      ],
      "env": {
        "OUTPUT_DIR": "<OUTPUT_DIR>"
      }
    }
  }
}
Run commanduvx 'git+https://github.com/Edison-A-N/[email protected]'
Environment variables to set
OUTPUT_DIR

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
pypigit+https://github.com/Edison-A-N/[email protected]

Tools

3

Saved tool list · updated 2w ago

ParameterTypeRequiredDescription
output_dirstringNo
patent_numberstringYes

Details

From the project README

Patent Downloader SDK

A Python SDK for downloading patents from Google Patents with MCP support.

One-Line Install for AI Agents

Send the following instruction to your coding agent (OpenCode / Cursor / Claw, etc.) to auto-install and configure the skill:

Read https://raw.githubusercontent.com/Edison-A-N/patent_downloader/main/docs/skills/install.md and follow the steps to install.

See docs/skills/usage.md for detailed CLI usage.

Features

  • Download patent PDFs from Google Patents
  • Get patent information (title, inventors, assignee, etc.)
  • MCP server support
  • Command-line interface
  • Simple API with error handling
  • Support for batch downloading from files (TXT/CSV)

Installation

# Using uv (recommended)
uv add patent-downloader
uv add "patent-downloader[mcp]"

# Using pip
pip install patent-downloader
pip install "patent-downloader[mcp]"

Quick Start

Python API
from patent_downloader import PatentDownloader

# Download a patent
downloader = PatentDownloader()
success = downloader.download_patent("WO2013078254A1", "./patents")

# Get patent info
info = downloader.get_patent_info("WO2013078254A1")
print(f"Title: {info.title}")

# Download multiple patents
results = downloader.download_patents(["WO2013078254A1", "US20130123448A1"])

# Download patents from file
results = downloader.download_patents_from_file("patents.txt", has_header=False)
Command Line
# Download patents
patent-downloader download WO2013078254A1
patent-downloader download WO2013078254A1 US20130123448A1 --output-dir ./patents

# Download patents from file
patent-downloader download --file patents.txt
patent-downloader download --file patents.csv --has-header

# Get patent info
patent-downloader info WO2013078254A1

# Start MCP server
patent-downloader mcp-server
MCP Server

The MCP server provides these functions:

  • download_patent: Download a single patent
  • download_patents: Download multiple patents
  • get_patent_info: Get patent information

You can configure the default download directory using the OUTPUT_DIR environment variable in your MCP configuration. This allows you to set a fixed download path for all patent downloads.

Quick Install for Cursor

Using uvx (no installation required)

Basic installation (default download directory: ~/downloads):

cursor://anysphere.cursor-deeplink/mcp/install?name=patent-downloader&config=eyJjb21tYW5kIjogInV2eCIsICJhcmdzIjogWyItLXdpdGgiLCAibWNwIiwgInBhdGVudC1kb3dubG9hZGVyIiwgIm1jcC1zZXJ2ZXIiXX0

Note: If you need to customize the download directory, you'll need to manually edit your mcp.json file after installation and add the env section:

{
  "mcpServers": {
    "patent-downloader": {
      "command": "uvx",
      "args": ["--with", "mcp", "patent-downloader", "mcp-server"],
      "env": {
        "OUTPUT_DIR": "~/Downloads/patents"
      }
    }
  }
}
Manual Setup
# Start server
patent-downloader mcp-server

# Using uvx to run without installation (specify MCP dependencies):
uvx --with mcp patent-downloader mcp-server

API

PatentDownloader
# Download patent
downloader.download_patent(patent_number, output_dir=".")

# Download multiple patents
downloader.download_patents(patent_numbers, output_dir=".")

# Download patents from file
downloader.download_patents_from_file(file_path, has_header=False, output_dir=".")

# Get patent info
downloader.get_patent_info(patent_number)
PatentInfo
@dataclass
class PatentInfo:
    patent_number: str
    title: str
    inventors: List[str]
    assignee: str
    publication_date: str
    abstract: str
    url: Optional[str] = None

File Format Support

The SDK supports reading patent numbers from both TXT and CSV files:

TXT Files
  • One patent number per line
  • Optional header row (use --has-header flag)
  • Example: 
    WO2013078254A1
US20130123448A1
EP1234567A1
CSV Files
  • Single column of patent numbers
  • Optional header row (use --has-header flag)
  • Example: 
    patent_number
WO2013078254A1
US20130123448A1
EP1234567A1

License

MIT License

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.