| name | outlook-mail |
| description | An email platform that offers robust inbox organization, integrated calendar functionality, and enterprise-grade security for both individuals and organizations. Read and write Outlook Mail data through One: messages, mailfolders, messageextensions, messagerules, attachments, messageattachments and more, 278 actions with real parameter documentation. Use whenever the user asks to look something up in Outlook Mail, create or update a record there, or build code against the Outlook Mail API. |
Outlook Mail through One
An email platform that offers robust inbox organization, integrated calendar functionality, and enterprise-grade security for both individuals and organizations.
One exposes Outlook Mail through four MCP tools. The table below carries real action ids from One's knowledge base, so for a common operation you can skip search and go straight to reading the action's parameters.
How to run an action
- Find the action in the table below, or call
search_one_platform_actions with platform outlook-mail if it is not listed.
- Call
get_one_action_knowledge with the action id. Do this every time, including for actions in this table. The table gives you the id, not the parameters.
- Call
execute_one_action with parameters copied from that knowledge.
Never guess a parameter name, a body field, or an enum value. The knowledge has the real schema, and a guessed field is either a 400 or a silent write of the wrong thing.
Before you start
Call list_one_integrations once and confirm Outlook Mail is connected. If it is missing, the user has not connected it: say so and point them at https://app.withone.ai rather than reaching for raw HTTP.
Each connection carries an access field. If it reports {"policy": "methods", "methods": ["GET"]} the agent is read-only here, so plan a read-only answer instead of attempting a write that will be refused.
Before a write
Creates, updates, deletes and sends land on a real Outlook Mail account and cannot be recalled. State the action and the specific target in one line before the first write in a task, and let the user stop you. Reads need no confirmation.
Actions
Messages
| Action | Method | Path | Action id |
|---|
| Count Messages in a Mail Folder | GET | /v1.0/me/mailFolders/{{mailFolderId}}/messages/$count | conn_mod_def::GMIYwkoSbgQ::_BYZvMFxThKK-zoweL5u6Q |
| Delta Messages for the Signed-in User | GET | /v1.0/me/messages/microsoft.graph.delta() | conn_mod_def::GMIYyZPGtXU::36XEPOMNQn61_ElgxJZx3w |
| Delta Messages in a Child Mail Folder | GET | /v1.0/me/mailFolders/{{mailFolderId}}/childFolders/{{mailFolderId1}}/messages/microsoft.graph.delta() | conn_mod_def::GMIYyQYVa3w::12ov3UsyRLyuTD7lAg7UDw |
| Delta Messages in a Mail Folder | GET | /v1.0/me/mailFolders/{{mailFolderId}}/messages/microsoft.graph.delta() | conn_mod_def::GMIYyQA6TWk::GyZb5kHdTgKObfjpdkvc4A |
| Delta Query a User’s Messages | GET | /users/{{userId}}/messages/microsoft.graph.delta() | conn_mod_def::GJ58zben6Ac::HYh0kRdhT02HufjETZnCQA |
| Delta Query Messages in a User’s Mail Folder | GET | /users/{{userId}}/mailFolders/{{mailFolderId}}/messages/microsoft.graph.delta() | conn_mod_def::GJ58xkp8RkE::7iO1yW_lQf29P4Pywc8RvQ |
| Get a Message for the Signed-in User | GET | /v1.0/me/messages/{{messageId}} | conn_mod_def::GMIYwjHgCAs::cvBtMvGiSnS7ZRG8Sj-trw |
| Get a Message from a Signed-in User's Mail Folder | GET | /v1.0/me/mailFolders/{{mailFolderId}}/messages/{{messageId}} | conn_mod_def::GMIYwZmNbLA::YAuzPZSxS4ewj9-b7V9aog |
| Get a Message in a User’s Mail Folder Child Folder | GET | /users/{{userId}}/mailFolders/{{mailFolderId}}/childFolders/{{mailFolderId1}}/messages/{{messageId}} | conn_mod_def::GJ58v94mg14::CTzaeR5NTuCucT19GyYntQ |
| Get a User Mail Folder Child Folder Message MIME Content | GET | /users/{{userId}}/mailFolders/{{mailFolderId}}/childFolders/{{mailFolderId1}}/messages/{{messageId}}/$value |
98 more Messages actions are available through search.
MailFolders
| Action | Method | Path | Action id |
|---|
| Delta Child Folders Using Me MailFolders | GET | /v1.0/me/mailFolders/{{mailFolderId}}/childFolders/microsoft.graph.delta() | conn_mod_def::GMIYyPp8vKI::4n6_I3cWRIOkZ0wb2NYrHQ |
| Delta Mail Folders for the Signed-in User | GET | /v1.0/me/mailFolders/microsoft.graph.delta() | conn_mod_def::GMIYyYd5jZ8::stu6d5GaQTqhcWIt1rtdgw |
| Delta Query a Mail Folder’s Child Folders (Mail Folder Delta) | GET | /users/{{userId}}/mailFolders/{{mailFolderId}}/childFolders/microsoft.graph.delta() | conn_mod_def::GJ58xisTRuk::Eg0FkDm3SRmbsZ4yTyoimQ |
| Get a Child Folder from a Signed-In User's Mail Folder | GET | /v1.0/me/mailFolders/{{mailFolderId}}/childFolders/{{mailFolderId1}} | conn_mod_def::GMIYv5vI9YE::S9cqjod8TGuUgLvlvShQjA |
| Get a Mail Folder’s Child Folder Count for a User | GET | /users/{{userId}}/mailFolders/{{mailFolderId}}/childFolders/$count | conn_mod_def::GJ58wWEcoOg::G6Rp4vyoRKS_RzxDK4Jy7A |
| Get a User Mail Folder’s Child Folder | GET | /users/{{userId}}/mailFolders/{{mailFolderId}}/childFolders/{{mailFolderId1}} | conn_mod_def::GJ58vhGtbkw::6v65InlvRo2m4n-PCVhuUA |
| Get a User’s Mail Folder | GET | /users/{{userId}}/mailFolders/{{mailFolderId}} | conn_mod_def::GJ58vuE8Ajs::3bNCMs7LQd2_6iDr6HnBrA |
| Get a User's Mail Folder Count | GET | /users/{{userId}}/mailFolders/$count | conn_mod_def::GJ58wNXiM1I::ce8SimVqQTGpAgk8bH7mag |
| Get Count of Child Folders in a Mail Folder | GET | /v1.0/me/mailFolders/{{mailFolderId}}/childFolders/$count | conn_mod_def::GMIYw6hkQhE::y6gueiDqQ8OPcLoIwHaRpA |
| Get Count of Mail Folders | GET | /v1.0/me/mailFolders/$count | conn_mod_def::GMIYwxB4Eb4::L2_POD_sSruJ2XRV0CwoZQ |
23 more MailFolders actions are available through search.
MessageExtensions
| Action | Method | Path | Action id |
|---|
| Count a Message's Extensions | GET | /v1.0/me/messages/{{messageId}}/extensions/$count | conn_mod_def::GMIYwzduPHw::83bPpByoQlqfzETFbKxzTg |
| Count Message Extensions in a Mail Folder | GET | /v1.0/me/mailFolders/{{mailFolderId}}/messages/{{messageId}}/extensions/$count | conn_mod_def::GMIYxL3zaR8::_-eGw8UjSWCAnOyR7SkC0w |
| Get a Message Extension Count in a User’s Child Mail Folder | GET | /users/{{userId}}/mailFolders/{{mailFolderId}}/childFolders/{{mailFolderId1}}/messages/{{messageId}}/extensions/$count | conn_mod_def::GJ58wZuDfh0::5eIXQvvGQjmTYUScQ38Hng |
| Get a Message Extension Count in a User’s Mail Folder | GET | /users/{{userId}}/mailFolders/{{mailFolderId}}/messages/{{messageId}}/extensions/$count | conn_mod_def::GJ58wk5P7ps::a3HgwzhhSVOua8oCfP7OiQ |
| Get a Message Extension for the Signed-in User | GET | /v1.0/me/messages/{{messageId}}/extensions/{{extensionId}} | conn_mod_def::GMIYwANIX7w::f3rqobdYTMSgC7L-HaN0LA |
| Get a Message Extension from a Child Mail Folder | GET | /v1.0/me/mailFolders/{{mailFolderId}}/childFolders/{{mailFolderId1}}/messages/{{messageId}}/extensions/{{extensionId}} | conn_mod_def::GMIYwBUR4w4::XJGSBlNxS4GfyK2IvEQX3Q |
| Get a Message Extension from a Signed-in User's Mail Folder | GET | /v1.0/me/mailFolders/{{mailFolderId}}/messages/{{messageId}}/extensions/{{extensionId}} | conn_mod_def::GMIYwBu-0GI::6oxr8JyhSS6SGQotFyN67w |
| Get a User Child Folder Message Extension | GET | /users/{{userId}}/mailFolders/{{mailFolderId}}/childFolders/{{mailFolderId1}}/messages/{{messageId}}/extensions/{{extensionId}} | conn_mod_def::GJ58viL_-3c::_nMQgCzVQxm0QZBWB43Ssw |
| Get a User Message Extension | GET | /users/{{userId}}/messages/{{messageId}}/extensions/{{extensionId}} | conn_mod_def::GJ58yNGq70Q::xS6ygTb2SVWidy4lOqy4SQ |
20 more MessageExtensions actions are available through search.
MessageRules
| Action | Method | Path | Action id |
|---|
| Count Message Rules in a Mail Folder | GET | /v1.0/me/mailFolders/{{mailFolderId}}/messageRules/$count | conn_mod_def::GMIYw6ikHJQ::7jerzgUlSYODxF0wwCZ7kw |
| Get a Child Folder Message Rule | GET | /v1.0/me/mailFolders/{{mailFolderId}}/childFolders/{{mailFolderId1}}/messageRules/{{messageRuleId}} | conn_mod_def::GMIYwSwJAzo::2AsdAgJuSg-U_q0Q3U09cw |
| Get a Child Folder Message Rule for a User | GET | /users/{{userId}}/mailFolders/{{mailFolderId}}/childFolders/{{mailFolderId1}}/messageRules/{{messageRuleId}} | conn_mod_def::GJ58wCp4ENE::fzq6haHqQ26cfJ39Lrkl_g |
| Get a Message Rule from a Signed-in User's Mail Folder | GET | /v1.0/me/mailFolders/{{mailFolderId}}/messageRules/{{messageRuleId}} | conn_mod_def::GMIYwTfFXRs::M32u7HgSShS-Z3_irjFXjQ |
| Get a User Mail Folder Message Rule | GET | /users/{{userId}}/mailFolders/{{mailFolderId}}/messageRules/{{messageRuleId}} | conn_mod_def::GJ58v7_6buM::FIGU_c_CRmC1jGVvs2-pvQ |
| Get a User Mail Folder Message Rules Count | GET | /users/{{userId}}/mailFolders/{{mailFolderId}}/messageRules/$count | conn_mod_def::GJ58wXDYXx4::LTcnYK-fTdCgDLVakAu3Uw |
| Get Count of Message Rules in a Child Mail Folder | GET | /v1.0/me/mailFolders/{{mailFolderId}}/childFolders/{{mailFolderId1}}/messageRules/$count | conn_mod_def::GMIYwzUag10::68XcyVptTE2pKAzXJ0EeMA |
| Get the Count of Message Rules in a User’s Child Mail Folder | GET | /users/{{userId}}/mailFolders/{{mailFolderId}}/childFolders/{{mailFolderId1}}/messageRules/$count | conn_mod_def::GJ58wMT_GAo::iUtu0HoXTvm5ZbfZ95m0Cw |
| List a User Mail Folder’s Message Rules | GET | /users/{{userId}}/mailFolders/{{mailFolderId}}/messageRules | conn_mod_def::GJ58v6pcHS4::FehQOazjSeCIr0yN9lAlTA |
|
12 more MessageRules actions are available through search.
Attachments
| Action | Method | Path | Action id |
|---|
| Count Attachments for a Message | GET | /v1.0/me/messages/{{messageId}}/attachments/$count | conn_mod_def::GMIYwzxvEFI::JjTPyDtWTgytEjs4iSq_Ug |
| Count Attachments for a Message in a Child Mail Folder | GET | /v1.0/me/mailFolders/{{mailFolderId}}/childFolders/{{mailFolderId1}}/messages/{{messageId}}/attachments/$count | conn_mod_def::GMIYw7ZONjk::eNxhh7oZR8S3OEUEHST3pg |
| Get a User MailFolder Message Attachment | GET | /users/{{userId}}/mailFolders/{{mailFolderId}}/messages/{{messageId}}/attachments/{{attachmentId}} | conn_mod_def::GJ58vTc1PXc::14hFHBaPRQCL1dX0IkOuOA |
| Get a User Message Attachment | GET | /users/{{userId}}/messages/{{messageId}}/attachments/{{attachmentId}} | conn_mod_def::GJ58yPQ2gcE::FI6N6Ox9QcKlzYgnURf8vg |
| Get a User Message Attachment (in a Child Mail Folder) | GET | /users/{{userId}}/mailFolders/{{mailFolderId}}/childFolders/{{mailFolderId1}}/messages/{{messageId}}/attachments/{{attachmentId}} | conn_mod_def::GJ58vX6EjhI::PARmU6QcSMWJjYs86QCfOA |
| Get Attachment From a Message in a Child Mail Folder | GET | /v1.0/me/mailFolders/{{mailFolderId}}/childFolders/{{mailFolderId1}}/messages/{{messageId}}/attachments/{{attachmentId}} | conn_mod_def::GMIYvwityWs::_5ckxH9RQtODThZ43QdBnA |
| Get the Count of a User Message’s Attachments (in a Mail Folder) | GET | /users/{{userId}}/mailFolders/{{mailFolderId}}/messages/{{messageId}}/attachments/$count | conn_mod_def::GJ58wW8wcR4::SgNmmXNJQKOKnE8R0NPR7g |
| Get the Count of a User’s Message Attachments (in a Child Mail Folder) | GET | /users/{{userId}}/mailFolders/{{mailFolderId}}/childFolders/{{mailFolderId1}}/messages/{{messageId}}/attachments/$count | conn_mod_def::GJ58wLeCmVc::TZ_Frq3zReiufXm6z4MKeg |
| List a User MailFolder Message's Attachments | GET | /users/{{userId}}/mailFolders/{{mailFolderId}}/messages/{{messageId}}/attachments |
8 more Attachments actions are available through search.
MessageAttachments
| Action | Method | Path | Action id |
|---|
| Get a Message Attachment | GET | /v1.0/me/messages/{{messageId}}/attachments/{{attachmentId}} | conn_mod_def::GMIYv5eUOKg::4wcbjhkXT9WF4mnwdC3SBw |
| Get a Message Attachment from a Mail Folder | GET | /v1.0/me/mailFolders/{{mailFolderId}}/messages/{{messageId}}/attachments/{{attachmentId}} | conn_mod_def::GMIYvvESkek::FeFK1983RTSWeH0Oga-NWA |
| Get a User Message’s Attachment Count | GET | /users/{{userId}}/messages/{{messageId}}/attachments/$count | conn_mod_def::GJ58yX2nnoc::lImJyfZRRRaAUO5hPLJkpg |
| List Message Attachments | GET | /v1.0/me/messages/{{messageId}}/attachments | conn_mod_def::GMIYv43QGDY::5nNtKctRRRC42n-GdMZT4Q |
| List Message Attachments in a Mail Folder | GET | /v1.0/me/mailFolders/{{mailFolderId}}/messages/{{messageId}}/attachments | conn_mod_def::GMIYvyG0jkk::8XBJzs07QaSOuyG1zziPhg |
| Create an Upload Session for a Message Attachment (in a User’s Child Mail Folder) | POST | /users/{{userId}}/mailFolders/{{mailFolderId}}/childFolders/{{mailFolderId1}}/messages/{{messageId}}/attachments/microsoft.graph.createUploadSession | conn_mod_def::GJ58w5NmpFo::eZfa6QyNTb6G3OuTOZnXoA |
| Create an Upload Session for a Message Attachment (in a User’s Mail Folder) | POST | /users/{{userId}}/mailFolders/{{mailFolderId}}/messages/{{messageId}}/attachments/microsoft.graph.createUploadSession | conn_mod_def::GJ58w5NnFcI::EDFyyjygSvO4qK8sGmDnrw |
| Create an Upload Session for a Message Attachment (Large File) | POST | /users/{{userId}}/messages/{{messageId}}/attachments/microsoft.graph.createUploadSession | conn_mod_def::GJ58y01yxxY::djpD4NhDSVaSTQuiX9J_5w |
| Create Upload Session for a Message Attachment | POST | /v1.0/me/messages/{{messageId}}/attachments/microsoft.graph.createUploadSession | conn_mod_def::GMIYxlUbc1k::4EutOSiKShCslus_oAh7Ug |
2 more MessageAttachments actions are available through search.
InferenceClassificationOverrides
| Action | Method | Path | Action id |
|---|
| Get a User’s Inference Classification Override | GET | /users/{{userId}}/inferenceClassification/overrides/{{inferenceClassificationOverrideId}} | conn_mod_def::GJ58t8ew4dU::icZcsZggTCqS1oEQAyQNOg |
| Get a User's Inference Classification Override Count | GET | /users/{{userId}}/inferenceClassification/overrides/$count | conn_mod_def::GJ58uNwMB-8::JejgdHwYQviipvb1mAI8hA |
| Get Count of Inference Classification Overrides | GET | /v1.0/me/inferenceClassification/overrides/$count | conn_mod_def::GMIYwiQHnnM::c4MMI-wfS7y66OsBXRZ0UQ |
| Get Override from Inference Classification for the Signed-in User | GET | /v1.0/me/inferenceClassification/overrides/{{inferenceClassificationOverrideId}} | conn_mod_def::GMIYwjGbc1A::ReObhXm8Q02LdIGOqkISVA |
| List a User’s Inference Classification Overrides | GET | /users/{{userId}}/inferenceClassification/overrides | conn_mod_def::GJ58t8hDPto::BcyFHD1lRA62IonP6_mrwQ |
| List Inference Classification Overrides | GET | /v1.0/me/inferenceClassification/overrides | conn_mod_def::GMIYwrQtiNI::PxMhsOKoQHSgXKQNej3NVA |
| Create an Inference Classification Override for a User | POST | /users/{{userId}}/inferenceClassification/overrides | conn_mod_def::GJ58t7aQRBY::xq-VFg5RSk-DYsTAK8_L9A |
| Create Override for the Signed-in User's Inference Classification | POST | /v1.0/me/inferenceClassification/overrides | conn_mod_def::GMIYvMDx3po::rTKm2EpITWWYvbvPp0d5rg |
| Delete a User's Inference Classification Override | DELETE | /users/{{userId}}/inferenceClassification/overrides/{{inferenceClassificationOverrideId}} | conn_mod_def::GJ58t9i0eOw::cMdjAwMQSUaTqH7VU1CtBg |
| Delete Inference Classification Override for the Signed-in User | DELETE |
MailFolder
| Action | Method | Path | Action id |
|---|
| Get a Signed-In User's Mail Folder | GET | /v1.0/me/mailFolders/{{mailFolderId}} | conn_mod_def::GMIYwLnGZN4::2R-0nkDoTaStEEt3qSNijg |
| Copy a Child Mail Folder | POST | /v1.0/me/mailFolders/{{mailFolderId}}/childFolders/{{mailFolderId1}}/microsoft.graph.copy | conn_mod_def::GMIYxMVoDaA::DwiyQqfHQX-r5H1gF75Qvg |
| Create a Child Folder in the Signed-in User's Mail Folder | POST | /v1.0/me/mailFolders/{{mailFolderId}}/childFolders | conn_mod_def::GMIYu70iIUo::-I25pCzHS-WB3ILQDWnr7g |
| Move a Child Mail Folder | POST | /v1.0/me/mailFolders/{{mailFolderId}}/childFolders/{{mailFolderId1}}/microsoft.graph.move | conn_mod_def::GMIYxtE6kM8::EECsNJ21REq24wqaWHK0qg |
| Move a Signed-In User's Mail Folder | POST | /v1.0/me/mailFolders/{{mailFolderId}}/microsoft.graph.move | conn_mod_def::GMIYx4HUC10::5SxgaKS_RKqL6RuELpvzDg |
| Update a Signed-In User's Mail Folder | PATCH | /v1.0/me/mailFolders/{{mailFolderId}} | conn_mod_def::GMIYy0plVjs::4bAvg8bTSr6Og2_35_0Lpw |
This lists 90 of 278 actions. For anything not here, call search_one_platform_actions with platform outlook-mail. The full catalog is at https://www.withone.ai/knowledge/outlook-mail.
When a call fails
The error comes from Outlook Mail, not from One. A 400 or 422 means your parameters do not match the schema, so re-read the knowledge and fix the field. A 401 or 403 means the connection needs re-authorizing, which no retry will fix. A 404 means the id is not on this account. A 429 means slow down. Never retry a write more than once: the first attempt may have landed.
Full catalog: https://www.withone.ai/knowledge/outlook-mail
Integration knowledge by One (withone.ai), licensed under One-Knowledge-1.0. Attribution must be preserved in derivative works.
