---
id: types-pyperclip
version: "1.11.0.20260508"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# types-pyperclip — Typing stubs for pyperclip

License: permissive · Maintenance: active · Downloads: 97.4K/mo

## What it is and what it does

types-pyperclip is a type stub package that supplies type annotations for the pyperclip clipboard library. It allows static type checkers like mypy (1.20.0) and pyright (1.1.408) to understand and validate code that calls pyperclip functions, catching type errors before runtime. The package is maintained as part of the typeshed project and tracks pyperclip version 1.11.*.

Type stubs are pure metadata—they contain no executable code and add zero runtime overhead. You install this package alongside pyperclip to enable type checking in your IDE and CI pipelines. It requires Python 3.10 or later and has no runtime dependencies.

Use it for:

- Enable mypy or pyright to type-check code that calls pyperclip.paste() or pyperclip.copy() without false positives
- Catch clipboard-related type errors in IDE type hints and linters before deployment
- Maintain type safety in projects that mix clipboard operations with strictly typed business logic

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Provides type annotations for the pyperclip clipboard library, enabling type checkers like mypy and pyright to validate code that uses pyperclip.

Yes, if you use pyperclip and run static type checking. It has no runtime cost, low install friction, and is actively maintained. Install it alongside pyperclip in your dev or type-checking dependencies. If you don't use type checkers, it provides no value.

## Install

pip install types-pyperclip
uv add types-pyperclip
poetry add types-pyperclip

## Installing types-pyperclip

Before you install: Low friction installation with no runtime dependencies. Actively maintained as part of the typeshed project with recent updates.

License in practice: Licensed under Apache-2.0 (permissive), allowing free use, modification, and distribution with minimal restrictions.

Quickstart:

pip install types-pyperclip

# In your code with pyperclip:
import pyperclip
text: str = pyperclip.paste()

Requires Python 3.10 or later. The actual pyperclip package must be installed separately for runtime use.

Verify before relying:

- Whether this package is automatically discovered by type checkers or requires explicit configuration in pyproject.toml or mypy.ini
- Coverage completeness: whether all pyperclip 1.11.* APIs are fully annotated

## Package facts

- License: Apache-2.0 (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 97.4K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

type stubs pyperclip, pyperclip type hints, type checking clipboard, mypy pyperclip annotations, pyright type stubs, python typing stubs, type-stubs, type-checking

[View on SkillFed](https://skillfed.io/packages/types-pyperclip) · [View on PyPI](https://pypi.org/project/types-pyperclip/)