# Outlook Local Calendar Loader
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 import download_loader
OutlookCalendarReader = download_loader("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/tree/main/llama_index) and/or subsequently used as a Tool in a [LangChain](https://github.com/hwchase17/langchain) Agent.
### LlamaIndex
```python
from llama_index import VectorStoreIndex, download_loader
OutlookCalendarReader = download_loader("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": "",
"name": "llama-index-readers-microsoft-outlook",
"maintainer": "tevslin",
"docs_url": null,
"requires_python": ">=3.8.1,<4.0",
"maintainer_email": "",
"keywords": "calendar,outlook",
"author": "Your Name",
"author_email": "you@example.com",
"download_url": "https://files.pythonhosted.org/packages/e7/d8/19ac4cf45579a563fa9d8cea557da853124dfb0e40ad82f318081fc30ea7/llama_index_readers_microsoft_outlook-0.1.3.tar.gz",
"platform": null,
"description": "# Outlook Local Calendar Loader\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 import download_loader\n\nOutlookCalendarReader = download_loader(\"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/tree/main/llama_index) and/or subsequently used as a Tool in a [LangChain](https://github.com/hwchase17/langchain) Agent.\n\n### LlamaIndex\n\n```python\nfrom llama_index import VectorStoreIndex, download_loader\n\nOutlookCalendarReader = download_loader(\"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.1.3",
"project_urls": null,
"split_keywords": [
"calendar",
"outlook"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "d631138faebcad1cc17ea1c74586f7c9de6cd23b5e8322a358374a1c2c059c14",
"md5": "a02ac2d9026bb698de0ec3a639ab5a6b",
"sha256": "8e5e30b33e811164d3148362c75db7e23da38feb212e1dc590b79895dba1d32a"
},
"downloads": -1,
"filename": "llama_index_readers_microsoft_outlook-0.1.3-py3-none-any.whl",
"has_sig": false,
"md5_digest": "a02ac2d9026bb698de0ec3a639ab5a6b",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8.1,<4.0",
"size": 4207,
"upload_time": "2024-02-21T20:22:35",
"upload_time_iso_8601": "2024-02-21T20:22:35.426849Z",
"url": "https://files.pythonhosted.org/packages/d6/31/138faebcad1cc17ea1c74586f7c9de6cd23b5e8322a358374a1c2c059c14/llama_index_readers_microsoft_outlook-0.1.3-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "e7d819ac4cf45579a563fa9d8cea557da853124dfb0e40ad82f318081fc30ea7",
"md5": "d14ddcd60033b971acb9fbcf56eb4e4e",
"sha256": "2c56ababe1d04025c4985183d8c9d1e2338a4f267dec91ab93215f40cdaf525e"
},
"downloads": -1,
"filename": "llama_index_readers_microsoft_outlook-0.1.3.tar.gz",
"has_sig": false,
"md5_digest": "d14ddcd60033b971acb9fbcf56eb4e4e",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8.1,<4.0",
"size": 3749,
"upload_time": "2024-02-21T20:22:37",
"upload_time_iso_8601": "2024-02-21T20:22:37.107756Z",
"url": "https://files.pythonhosted.org/packages/e7/d8/19ac4cf45579a563fa9d8cea557da853124dfb0e40ad82f318081fc30ea7/llama_index_readers_microsoft_outlook-0.1.3.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-02-21 20:22:37",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "llama-index-readers-microsoft-outlook"
}