{"id":13314163,"url":"https://github.com/joplin/plugin-email","last_synced_at":"2025-04-23T04:36:39.152Z","repository":{"id":37027281,"uuid":"503094395","full_name":"joplin/plugin-email","owner":"joplin","description":" This plugin adds the ability to fetch email messages and converts them to Joplin notes in various formats, either by monitoring any new or unread messages from a specific email address or a specific mailbox, or by uploading downloaded email messages to the plugin without having to be logged in.","archived":false,"fork":false,"pushed_at":"2023-08-08T19:27:38.000Z","size":364,"stargazers_count":35,"open_issues_count":16,"forks_count":4,"subscribers_count":6,"default_branch":"main","last_synced_at":"2025-04-02T08:23:12.517Z","etag":null,"topics":["email","email-plugin","joplin","joplin-plugin"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/joplin.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2022-06-13T19:48:50.000Z","updated_at":"2025-03-26T00:24:01.000Z","dependencies_parsed_at":"2023-01-24T22:46:21.531Z","dependency_job_id":null,"html_url":"https://github.com/joplin/plugin-email","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/joplin%2Fplugin-email","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/joplin%2Fplugin-email/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/joplin%2Fplugin-email/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/joplin%2Fplugin-email/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/joplin","download_url":"https://codeload.github.com/joplin/plugin-email/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250372522,"owners_count":21419719,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["email","email-plugin","joplin","joplin-plugin"],"created_at":"2024-07-29T18:11:02.256Z","updated_at":"2025-04-23T04:36:38.511Z","avatar_url":"https://github.com/joplin.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003ch1 align = \"center\" \u003e Email Plugin \u003c/h1\u003e\n\nThis plugin adds the ability to fetch email messages (including attachments) and converts them to Joplin notes in various formats, either by monitoring any `new` or `unread` messages from a specific email address or a specific mailbox, or by uploading downloaded email messages to the plugin without having to be logged in.\n\n***\n\n## Installing Plugin\n\n- Open Joplin\n- Go to Tools \u003e Options \u003e Plugins\n- Search for `Email Plugin`\n- Click Install plugin\n- Restart Joplin to enable the plugin\n\n***\n\n## Features\n\n- Monitoring and fetching any `new` or `unread` messages from a specific email address.\n\n- Monitoring and fetching any `new` or `unread` messages from a specific mailbox.\n\n- Send the converted message to specific notebooks and add tags to the note by using `@` or `#` in the email subject or first line of email content and then forward the email to yourself.\n\n- Convert emails (including attachments) to notes without having to be logged into the plugin.\n\n- Convert email messages to notes in different formats (`HTML`, `Markdown`, `Text`).\n\n- Show attachments in different styles, whether they are in the form of a `Table` or `Links`.\n\n***\n\n## How to use\n\n- ### Monitoring and fetching from a specific email address\n\n  - Open Email Plugin.\n\n  - Login to the plugin with your email address and password.\n\n  - Enter the email account you want to start fetching and monitoring `new` or `unread` messages from and click on the `Fetching \u0026 Monitoring` toggle.\n\n    - If you enter your email address in the `from` field, simply forward the email message to yourself after adding some easy syntax to the end of the email subject, or add this syntax in a new line at the beginning of the message content, and the plugin will handle the rest.\n\n      - **Set a note title** : Change note title by changing the subject of the email.\n      - **Add to a notebook** : Add `@notebook` to send it to a specific notebook.\n      - **Add tags** : Add `#tag` to organize the note with a tag.\n\n        \u003e **For example**: Say you want this email located in the **joplin** and **gmail** folders and also want to add **gmail** and **email** as tags to the note. Just edit the email subject or add a new line at the beginning of the message content like this:\n        \u003e\u003eEmail subject: My message @**joplin** @**email** #**gmail** #**email**\n        \n        https://user-images.githubusercontent.com/58605547/188909511-479bff3b-bb9c-42da-9d48-a29d8b22fd4b.mp4\n        \n    - Otherwise the email messages will be in the `email messages` folder.\n\n***\n\n- ### Monitoring and fetching from a specific mailbox\n\n  - Open Email Plugin.\n\n  - Login to the plugin with your email address and password.\n\n  - Select a specific mailbox and notebook in which you want the email messages to be located and click on the `Fetching \u0026 Monitoring Mailbox` toggle.\n\n***\n\n- ### Upload downloaded email messages\n\n  - Open Email Plugin.\n\n  - Click on the `convert saved messages` button.\n  \n  - Upload `.eml` format files of email messages that you want to convert to notes.\n\n  - Select a notebook, enter the tags, select the export options, and click on the `convert` button.\n\n## Important Notes\n\n- ⚠️ Make sure the email provider allows login using the original password; otherwise, use the [app password](https://support.google.com/accounts/answer/185833?hl=en#:~:text=Create%20%26%20use%20App%20Passwords).\n\n- If you want to change the note format, remove attachments from the note, or change the attachments style while monitoring, go to `Tools` \u003e `Email Plugin`.\n\n- If you mention folders or tags that don't exist in Joplin, they will be created automatically.\n\n- If you open the email message, the message is no longer `new` or `unread`, but you can easily mark it as unread again.\n\n## Building the plugin\n\nThe plugin is built using Webpack, which creates the compiled code in `/dist`. A JPL archive will also be created at the root, which can use to distribute the plugin.\n\nTo build the plugin, simply run `npm run dist`.\n\nThe project is setup to use TypeScript, although you can change the configuration to use plain JavaScript.\n\n## Testing\n\nTo test the plugin, simply run `npm test`. The testing library used is [Jest](https://jestjs.io/).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjoplin%2Fplugin-email","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjoplin%2Fplugin-email","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjoplin%2Fplugin-email/lists"}