numbers-parser

numbers-parser is a Python module for reading and editing Apple Numbers.numbers files. It supports Numbers files generated by Numbers versions 3.x and later. It is tested against Numbers documents from 10.0 through to 14.4 (the last version of Numbers) and Numbers Creator Studio up to version 15.1, which the most current as of February 2026.

It supports and is tested against Python versions from 3.10 onwards. It is not compatible with earlier versions of Python.

Getting started

Start with these documents to get you up and running:

• Quick Start
  • Cell Data
  • Pandas Support
  • Writing Numbers Documents
  • Styles
  • Cell Data Formatting
  • Borders
• Installation
• Command-line scripts
  • cat-numbers
  • csv2numbers
    • Deleting columns
    • Renaming columns
    • Date columns
    • Transforming columns
• Limitations

API Reference

• Document Class
  • Document
• Sheet Class
  • Sheet
• Table Class
  • Table
• Cell Classes
  • Cell
  • MergedCell
  • RichTextCell
• Date/time Formatting
• Style Class
  • Style
  • BackgroundImage
• Border Class
  • Border
• Cell Reference Functions
  • xl_cell_to_rowcol()
  • xl_range()
  • xl_rowcol_to_cell()
  • xl_col_to_name()
• Enumerations
  • NegativeNumberStyle
  • FractionAccuracy
  • PaddingType
• Development
  • Numbers File Formats
  • Credits
• Changes in version 4.0

License

All code in this repository is licensed under the MIT License.