matimo-gmail

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

Installation

pip install matimo matimo-gmail

Available Tools (6 Total)

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': 'user@example.com',
        '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