> For the complete documentation index, see [llms.txt](https://docs.msgfiler.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.msgfiler.com/support/plugin/install.md).

# Installing the Classic Plug-In

MsgFiler is an Apple Mail Plug-In. To install and configure MsgFiler, follow these instructions:

1. Quit the **Mail** application.
2. Go to the **Finder**
3. Hold the **Option** key and click on the Go menu
4. Choose **Library**
5. Navigate to the **Mail** directory in the **Library** directory
6. Drag **MsgFilerPlugIn.mailbundle** to Bundles folder in the Mail directory. Create the **Bundles** folder if it does not already exist.
7. If you have never used or installed a Mail plug-in like MsgFiler Classic, you will need to run the following commands in the **Terminal** application:\
   If you are using macOS 10.14 or higher, paste and press enter:

```
sudo defaults write "/Library/Preferences/com.apple.mail" EnableBundles 1
defaults write com.apple.mail EnableBundles -bool true
defaults write com.apple.mail BundleCompatibilityVersion 4
```

{% hint style="danger" %}
You will have to enter your Administrator password after the first command.
{% endhint %}

If you are using OS X 10.7 or higher, paste and press enter:

```
defaults write com.apple.mail EnableBundles -bool true
defaults write com.apple.mail BundleCompatibilityVersion 4
```

If you are using OS X 10.6/Snow Leopard, paste and press enter:

```
defaults write com.apple.mail EnableBundles -bool true
defaults write com.apple.mail BundleCompatibilityVersion 3
```

8. Launch **Mail**.
9. If you are using **macOS 10.14 Mojave or higher**, open Mail Preferences
   1. Click **Manage Plug-Ins.**
   2. Ensure that **MsgFiler Engine** is checked.
   3. Click **Apply and Restart Mail.**

## Setting a Keyboard Equivalent for MsgFiler

Next you will create a custom keyboard shortcut to activate MsgFiler in the Mail application.

1. Choose **System Preferences…** from the Apple menu.
2. Click **Keyboard & Mouse.**
3. Click **Keyboard Shortcuts** tab.
4. Click the **+** icon.
5. In the sheet that appears, choose **Mail** from the **Application** menu
6. Enter **Move with MsgFiler** in the **Menu Title** field.
7. Enter the keyboard shortcut of your choice in the **Keyboard Shortcut** field. For instance, **Command-9.**
8. Click **Add.**

MsgFiler is now ready for use! You can open MsgFiler via the Message menu or by typing **Command-9** on the keyboard while in the Mail application.\ <br>

<br>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.msgfiler.com/support/plugin/install.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
