Metadata-Version: 2.4
Name: barie-gmail-mcp
Version: 0.1.1
Summary: Gmail MCP Server for managing Gmail via the Model Context Protocol
Author-email: Barie <support@barie.ai>
License: MIT
Keywords: gmail,google-api,mcp,model-context-protocol
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.9
Requires-Dist: google-api-python-client>=2.130.0
Requires-Dist: google-auth-oauthlib>=1.2.0
Requires-Dist: google-auth>=2.29.0
Requires-Dist: mcp>=0.9.0
Description-Content-Type: text/markdown

# Barie Gmail MCP

A Model Context Protocol (MCP) server for interacting with Gmail accounts.

## Installation

Install with `uvx`:

```bash
uvx --from . barie-gmail-mcp --help
```

Or install with pip:

```bash
pip install -e .
```

## Usage

Run the MCP server:

```bash
barie-gmail-mcp \
  --access-token "<access_token>" \
  --refresh-token "<refresh_token>" \
  --client-id "<google_client_id>" \
  --client-secret "<google_client_secret>" \
  --expiry "<optional_iso_expiry>" \
  --attachments-dir "./attachments"
```

### Required arguments

- `--access-token`: OAuth2 access token
- `--refresh-token`: OAuth2 refresh token
- `--client-id`: Google OAuth client ID
- `--client-secret`: Google OAuth client secret

### Optional arguments

- `--expiry`: Access token expiry in ISO format
- `--attachments-dir`: Local path for saving attachments
- `--scopes`: Optional custom scopes list

## Features

- Draft, read, and send emails
- Read unread messages and search mail
- Label and folder management
- Email filter management
- Archive/restore and trash operations

## Development

From the `barie_gmail_mcp` directory:

```bash
python server.py --help
```
