Add microsoft email management ability

[RyanBhandal]

What does this Ability do?

A Microsoft email management system that allows users to read, send, archive emails through their voice!

Suggested Trigger Words

• Outlook

Type

• New community Ability
• Improvement to existing Ability
• Bug fix
• Documentation update

External APIs

• No external APIs
• Uses external API(s):

Testing

• Tested in OpenHome Live Editor
• All exit paths tested (said "stop", "exit", etc.)
• Error scenarios tested (API down, bad input, etc.)

Checklist

• Files are in community/my-ability-name/
• main.py follows SDK pattern (extends MatchingCapability, has register_capability + call)
• README.md included with description, suggested triggers, and setup
• resume_normal_flow() called on every exit path
• No print() — using editor_logging_handler
• No hardcoded API keys — using placeholders
• No blocked imports (redis, connection_manager, user_config)
• No asyncio.sleep() or asyncio.create_task() — using session_tasks
• Error handling on all external calls
• Tested in OpenHome Live Editor

Anything else?

(https://www.loom.com/share/34b771d323d8455b94d3665cf7582810)

[github-actions]

🔀 Branch Merge Check

PR direction: Microsoft-mail-management-ability → dev

✅ Passed — Microsoft-mail-management-ability → dev is a valid merge direction

[github-actions]

✅ Ability Validation Passed

📋 Validating: community/MicrosoftMail
  ✅ All checks passed!

[github-actions]

🔍 Lint Results

🔧 Auto-formatted

Some files were automatically cleaned and formatted with autoflake + autopep8 and committed.

• ✅ Unused imports removed (autoflake)
• ✅ Unused variables removed (autoflake)
• ✅ PEP8 formatting applied (autopep8)

✅ __init__.py — Empty as expected

Files linted: community/MicrosoftMail/main.py community/MicrosoftMail/refresh_token/get_refresh_token.py

✅ Flake8 — Passed

✅ All checks passed!

[RyanBhandal]

if i had access to config, i would add these as trigger words

ofcourse Outlook was the singular one I used/tested with however this "shouldnt" cause harm.

"matching_hotwords": [
    "email", "emails", "inbox", "outlook",
    "unread emails", "new emails", "check my email",
    "check email", "read my email", "read email",
    "any new email", "do I have email",
    "send an email", "send email", "write an email",
    "reply to email", "email from",
    "triage my email", "go through my email",
    "catch me up on email", "what's in my inbox",
    "email summary"
]

[Rizwan-095]

Kindly look at the validate_ability.py file in root directory of this repo again there are few changes so build your ability according to that.
Also look at these docs.
https://docs.openhome.com/how_to_build_an_ability

[RyanBhandal]

No worries - will take a look

If you explicitly pass utf-8, it passes by the way

[RyanBhandal]

Can you recheck

[Rizwan-095]

Thanks! Team will test and provide feedback accordingly.

[codermohsin]

Hi,

I have reviewed your ability and set up my account along with the access token, but it is not working on my end.

Could you please share a demo video showing the complete setup process, including:

Account configuration

Access token setup

Running the ability

Connecting and authorizing the email

This will help me reproduce the steps correctly and verify the integration from my side.

Thank you.

[RyanBhandal]

From my knowledge, the issue isn't the instructions, it is the way we are triggering it. You have said on Discord you are having trouble triggering it but so I am now.

This is because you have changed how you want register capability to work. You have disallowed 'open' however all PR I see are using this.. Originally this is how I was triggering my ability which was working.

Please can you confirm the correct way to set up register capabilities.

[RyanBhandal]

Code has been updated to use the correct registry compatibility

[RyanBhandal]

@codermohsin Could you please re test the code, the trigger should work now - Thanks

[codermohsin]

Under review