odoo-addon-fetchmail-attach-from-folder

Email gateway - folders

Adds the possibility to attach emails from a certain IMAP folder to objects, ie partners. Matching is done via several algorithms, ie email address, email address’s domain or the original Odoo algorithm.

This gives a simple possibility to archive emails in Odoo without a mail client integration.

Table of contents

Configuration

In your fetchmail configuration, you’ll find a new list field Folders to monitor. Add your folders here in IMAP notation (usually something like INBOX.your_folder_name.your_subfolder_name), choose a model to attach mails to and a matching algorithm to use.

Exact mailaddress

Fill in a field to search for the email address in Field (model). For partners, this would be email. Also fill in the header field from the email to look at in Field (email). If you want to match incoming mails from your customers, this would be from. You can also list header fields, so to match partners receiving this email, you might fill in to,cc,bcc.

Domain of email addresses

Match the domain of the email address(es) found in Field (email). This would attach a mail to test1@example.com to a record with Field (model) set to test2@example.com. Given that this is a fuzzy match, you probably want to check Use 1st match, because otherwise nothing happens if multiple possible matches are found.

Odoo standard

This is stricly speaking no matching algorithm, but calls the model’s standard action on new incoming mail, which is usually creating a new record.

Usage

A widespread configuration is to have a shared mailbox with several folders, i.e. one where users drop mails they want to attach to partners. Let this folder be called From partners. Then create a folder configuration for your server with path "INBOX.From partners" (note the quotes because of the space, this is server dependent). Choose model Partners, set Field (model) to email and Field (email) to from. In Domain, you could fill in [('customer', '=', True)] to be sure to only match customer records.

Now when your users drop mails into this folder, they will be fetched by Odoo and attached to the partner in question. After some testing, you might want to check Delete matches in your folder configuration so that this folder doesn’t grow indefinitely.

Another way to prevent having to process ever more messages from the folder to read is to automatically move all processed messages to an archive folder that can be specified.

Therp BV

Contributors

Holger Brunn hbrunn@therp.nl
Ronald Portier ronald@therp.nl
Alexandre Fayolle alexandre.fayolle@camptocamp.com

Maintainers

This module is maintained by the OCA.

OCA, or the Odoo Community Association, is a nonprofit organization whose mission is to support the collaborative development of Odoo features and promote its widespread use.

Current maintainer:

This module is part of the OCA/server-tools project on GitHub.

You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.

Release files for odoo-addon-fetchmail-attach-from-folder 18.0.2.0.0.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Built distribution (wheel)

Table of built distributions (wheels) for odoo-addon-fetchmail-attach-from-folder 18.0.2.0.0.2
File	Interpreter	ABI	Platform	Reset
odoo_addon_fetchmail_attach_from_folder-18.0.2.0.0.2-py3-none-any.whl 79.6 kB Jun 8, 2026	Python 3	none	any	Details

Release files / odoo_addon_fetchmail_attach_from_folder-18.0.2.0.0.2-py3-none-any.whl

Download URL	odoo_addon_fetchmail_attach_from_folder-18.0.2.0.0.2-py3-none-any.whl
Size	79.6 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`738122ef5629f8eabb20fb07bd44a6d807700ef13ba6bc563ba50302e1d786a8`
BLAKE2b-256 checksum How to use checksums	`bc3f5f4b4ca70021332d973d7bf9c0e6577891fb1565c8b8e255899144aadec8`
Upload date	Jun 8, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.2.0 CPython/3.12.3`