Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

Python icalendar (rfc5545) parser

Project Description

Original repository (GitHub) - Bugtracker and issues (GitHub) - PyPi package (ics) - Documentation (Read The Docs). is a pythonic and easy iCalendar library. It’s goals are to read and write ics data in a developer friendly way.

iCalendar is a widely-used and useful format but not user friendly. is there to give you the ability of creating and reading this format without any knowledge of it.

It should be able to parse every calendar that respects the rfc5545 and maybe some more… It also outputs rfc compliant calendars.

iCalendar (file extension .ics) is used by Sunbird, Google Calendar, Apple Calendar, Android… is available for Python>=2.7 and Python>=3.3 and is Apache2 Licensed.


$ pip install ics
>>> from ics import Calendar, Event
>>> c = Calendar()
>>> e = Event()
>>> = "My cool event"
>>> e.begin = '20140101 00:00:00'
[<Event 'My cool event' begin:2014-01-01 00:00:00 end:2014-01-01 00:00:01>]
>>> with open('my.ics', 'w') as my_file:
>>>     my_file.writelines(c)
>>> # and it's done !

More examples are available in the documentation.


All the documentation is hosted on and is updated automatically at every commit.


Contribution are welcome of course! For more information, see contributing.

Release History

This version
History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, Size & Hash SHA256 Hash Help File Type Python Version Upload Date
(16.4 kB) Copy SHA256 Hash SHA256
Egg 2.7 Mar 24, 2015
(19.2 kB) Copy SHA256 Hash SHA256
Wheel 2.7 Mar 24, 2015
(38.6 kB) Copy SHA256 Hash SHA256
Egg 3.4 Mar 24, 2015
(37.3 kB) Copy SHA256 Hash SHA256
Source None Mar 24, 2015

Supported By

Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Kabu Creative Kabu Creative UX & Design Google Google Cloud Servers Fastly Fastly CDN StatusPage StatusPage Statuspage DigiCert DigiCert EV Certificate