matimo-gmail 0.1.0

Matimo provider — Gmail tools (send, list, read, delete emails)

matimo-gmail

Gmail tools for Matimo — send, list, read, and delete emails.

---

Installation

pip install matimo matimo-gmail

---

Available Tools (6 Total)

Tool	Description
send-email	Send an email (to, subject, body, cc, bcc, html)
list-messages	List messages with optional query/label filters
get-message	Get full message content by ID
create-draft	Create a draft email
delete-message	Move message to trash

---

Quick Start

import asyncio
from matimo import Matimo
from matimo_gmail import get_tools_path

async def main():
    matimo = await Matimo.init(get_tools_path())

    # Send an email
    await matimo.execute('send-email', {
        'to': '[e-mail]',
        'subject': 'Hello from Matimo',
        'body': 'This message was sent by an AI agent.',
    })

    # List recent messages
    result = await matimo.execute('list-messages', {
        'query': 'is:unread',
        'max_results': 10,
    })

asyncio.run(main())

---

Authentication

Gmail tools use OAuth2. Set your credentials via environment variables:

export GMAIL_ACCESS_TOKEN="ya29.your-oauth2-access-token"
# Or use a service account
export GMAIL_SERVICE_ACCOUNT_JSON="/path/to/service-account.json"

Getting an Access Token (OAuth2)

1. Create a project in Google Cloud Console
2. Enable the Gmail API
3. Create OAuth 2.0 credentials (Desktop app)
4. Run the OAuth flow to get an access token

---

Documentation

• Gmail API Reference
• Python Examples

---

Links

• PyPI: https://pypi.org/project/matimo-gmail/
• GitHub: https://github.com/tallclub/matimo
• Gmail API Docs: https://developers.google.com/gmail/api