# Outlook Local Calendar Loader
```bash
pip install llama-index-readers-microsoft-outlook
```
This loader reads your past and upcoming Calendar events from your local Outlook .ost or .pst and parses the relevant info into `Documents`.
It runs on Windows only and has only been tested with Windows 11. It has been designed to have a supoerset of the functionality of the Google Calendar reader.
## Usage
Here's an example usage of the OutlookCalendar Reader. It will retrieve up to 100 future events, unless an optional `number_of_results` argument is passed. It will also retrieve only future events, unless an optional `start_date` argument is passed. Optionally events can be restricted to those which occur on or before a specific date by specifying the optional `end-date` parameter. By default, `end-date` is 2199-01-01.
It always returns Start, End, Subject, Location, and Organizer attributes and optionally returns additional attributes specified in the `more_attributes` parameter, which, if specified, must be a list of strings eg. ['Body','someotherattribute',...]. Attributes which don't exist in a calendar entry are ignored without warning.
```python
from llama_index.readers.microsoft_outlook import OutlookLocalCalendarReader
loader = OutlookCalendarReader()
documents = loader.load_data()
```
## Example
This loader is designed to be used as a way to load data into [LlamaIndex](https://github.com/run-llama/llama_index/).
### LlamaIndex
```python
from llama_index.core import VectorStoreIndex, download_loader
from llama_index.readers.microsoft_outlook import OutlookLocalCalendarReader
loader = OutlookCalendarReader(
start_date="2022-01-01", number_of_documents=1000
)
documents = loader.load_data()
index = VectorStoreIndex.from_documents(documents)
index.query("When did I last see George Guava? When do I see him again?")
```
Note: it is actually better to give a structured prompt with this data and be sure to it is clear what today's date is and whether you want any data besides the indexed data used in answering the prompt.
Raw data
{
"_id": null,
"home_page": null,
"name": "llama-index-readers-microsoft-outlook",
"maintainer": "tevslin",
"docs_url": null,
"requires_python": "<4.0,>=3.8.1",
"maintainer_email": null,
"keywords": "calendar, outlook",
"author": "Your Name",
"author_email": "you@example.com",
"download_url": "https://files.pythonhosted.org/packages/4a/d3/8898fd21ca0f30c2251d1d941fe48deb8245b5598af277142de0d5c63ee0/llama_index_readers_microsoft_outlook-0.2.0.tar.gz",
"platform": null,
"description": "# Outlook Local Calendar Loader\n\n```bash\npip install llama-index-readers-microsoft-outlook\n```\n\nThis loader reads your past and upcoming Calendar events from your local Outlook .ost or .pst and parses the relevant info into `Documents`.\n\nIt runs on Windows only and has only been tested with Windows 11. It has been designed to have a supoerset of the functionality of the Google Calendar reader.\n\n## Usage\n\nHere's an example usage of the OutlookCalendar Reader. It will retrieve up to 100 future events, unless an optional `number_of_results` argument is passed. It will also retrieve only future events, unless an optional `start_date` argument is passed. Optionally events can be restricted to those which occur on or before a specific date by specifying the optional `end-date` parameter. By default, `end-date` is 2199-01-01.\n\nIt always returns Start, End, Subject, Location, and Organizer attributes and optionally returns additional attributes specified in the `more_attributes` parameter, which, if specified, must be a list of strings eg. ['Body','someotherattribute',...]. Attributes which don't exist in a calendar entry are ignored without warning.\n\n```python\nfrom llama_index.readers.microsoft_outlook import OutlookLocalCalendarReader\n\nloader = OutlookCalendarReader()\ndocuments = loader.load_data()\n```\n\n## Example\n\nThis loader is designed to be used as a way to load data into [LlamaIndex](https://github.com/run-llama/llama_index/).\n\n### LlamaIndex\n\n```python\nfrom llama_index.core import VectorStoreIndex, download_loader\n\nfrom llama_index.readers.microsoft_outlook import OutlookLocalCalendarReader\n\nloader = OutlookCalendarReader(\n start_date=\"2022-01-01\", number_of_documents=1000\n)\n\ndocuments = loader.load_data()\nindex = VectorStoreIndex.from_documents(documents)\nindex.query(\"When did I last see George Guava? When do I see him again?\")\n```\n\nNote: it is actually better to give a structured prompt with this data and be sure to it is clear what today's date is and whether you want any data besides the indexed data used in answering the prompt.\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "llama-index readers microsoft outlook integration",
"version": "0.2.0",
"project_urls": null,
"split_keywords": [
"calendar",
" outlook"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "23e708319196c321a799a1b26a9609fd28eaba32e18aa0a9ea5336dbcca0350c",
"md5": "d86b365dd296a3c5ab696baef7ca9bf3",
"sha256": "f24e2cdd62fc2c7953da276e857d2edec578c0796a241c4717294105ef1568c2"
},
"downloads": -1,
"filename": "llama_index_readers_microsoft_outlook-0.2.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "d86b365dd296a3c5ab696baef7ca9bf3",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<4.0,>=3.8.1",
"size": 4173,
"upload_time": "2024-08-22T06:36:25",
"upload_time_iso_8601": "2024-08-22T06:36:25.345116Z",
"url": "https://files.pythonhosted.org/packages/23/e7/08319196c321a799a1b26a9609fd28eaba32e18aa0a9ea5336dbcca0350c/llama_index_readers_microsoft_outlook-0.2.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "4ad38898fd21ca0f30c2251d1d941fe48deb8245b5598af277142de0d5c63ee0",
"md5": "35237a9408fed63afca94dcb732ce9bb",
"sha256": "24698bf0eb318c551e7228c004dc1bf101d2d4fe155d3e99a50d43df935ee125"
},
"downloads": -1,
"filename": "llama_index_readers_microsoft_outlook-0.2.0.tar.gz",
"has_sig": false,
"md5_digest": "35237a9408fed63afca94dcb732ce9bb",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<4.0,>=3.8.1",
"size": 3739,
"upload_time": "2024-08-22T06:36:26",
"upload_time_iso_8601": "2024-08-22T06:36:26.617383Z",
"url": "https://files.pythonhosted.org/packages/4a/d3/8898fd21ca0f30c2251d1d941fe48deb8245b5598af277142de0d5c63ee0/llama_index_readers_microsoft_outlook-0.2.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-08-22 06:36:26",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "llama-index-readers-microsoft-outlook"
}
JSON