Skip to main content

Notion Python Client (NPC)

pytthon-versions codecov example workflow

Introduction

NPC (Notion Python Client) is a Python library that simplifies interactions with the Notion API. With this library, you can effortlessly integrate your Python applications with Notion, allowing you to create, retrieve, update, and manage Notion pages, databases, and more, all within your Python code.

Features

  • Simple and Intuitive: NPC provides a user-friendly interface to interact with the Notion API. Whether you are a seasoned developer or new to Notion, you'll find it easy to get started.

  • Diverse Functionality: You can perform a wide range of actions using NPC, such as creating new pages, updating page content, retrieving database entries, and much more.

  • Authentication: NPC takes care of the authentication process, allowing you to focus on your application logic without worrying about the intricacies of the API's authentication flow.

  • Customization: The library is designed to be flexible, making it easy to adapt to your specific project requirements. You can use it to integrate Notion with your websites, productivity tools, or automate your Notion workspace.

Installation

You can install NPC using pip:

pip install notion-python-client

Getting Started

  1. Authentication Setup: To use NPC, you need to create an integration in your Notion workspace and obtain an API token. Follow our authentication guide to set this up.

  2. Import NPC: Import the library into your Python script:

from notion_python_client import NPC
  1. Create a Notion Client: Initialize a Notion client with your API token:
client = NPC("YOUR_API_TOKEN")
  1. Interact with Notion: You're ready to start using NPC to interact with Notion. Here's an example of creating a new page:
pages = client.database_handler.get_pages("YOUR_DATABASE_ID")

Documentation

For detailed documentation, please visit the NPC Documentation.

Examples

Explore our examples directory for sample Python scripts that showcase various use cases of NPC. (Coming Soon)






Thank you for choosing NPC for your Notion integration needs! We look forward to seeing what you build with it. Happy coding!

Metadata

Release files for notion-python-client 0.0.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for notion-python-client 0.0.2
File Size Uploaded
notion_python_client-0.0.2.tar.gz 16.2 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for notion-python-client 0.0.2
File Interpreter ABI Platform
notion_python_client-0.0.2-py3-none-any.whl Python 3 none any Details

Total release size: 45.5 kB

Release files / notion_python_client-0.0.2.tar.gz

Download URL notion_python_client-0.0.2.tar.gz
Size 16.2 kB
Tags Source
SHA-256 checksum
How to use checksums
04dcc197017f2bc4d8eb22f4c566faa52e7794992dd9c5ebc45ceb4b1415401b
BLAKE2b-256 checksum
How to use checksums
24c6465654667d5efb619da287ac4ef1b77dbb199d9e0ccc2bde6fc01eaa3475
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.12.9

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Apr 27, 2025.

Transparency log

Release files / notion_python_client-0.0.2-py3-none-any.whl

Download URL notion_python_client-0.0.2-py3-none-any.whl
Size 29.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
b0b49a20e11ddeb8c103e7f18112b42d834fa5271f11f705e8d991d844387091
BLAKE2b-256 checksum
How to use checksums
029b764d756fe1937e5125c5b5a8e621d88df92ff661a84db6f226b4c2a892cb
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.12.9

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Apr 27, 2025.

Transparency log
Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page