The AVA MCP Server enables AI applications to create email drafts using the Gmail API. It integrates with the Model Context Protocol (MCP) to provide the following capabilities:
Create Email Drafts: Specify recipients, subject, and body content for draft emails in Gmail
Google OAuth Integration: Securely authenticates with Gmail using OAuth credentials and permissions
Customization: Behavior can be personalized by updating details in the
prompts/ava.md
fileEnvironment Configuration: Uses variables like
USER_EMAIL
and credential paths for authenticationSecurity: Protects sensitive authentication files from version control
Provides access to Gmail API, allowing the AI assistant (AVA) to read and manage emails through the Gmail service.
Integrates with Google services through OAuth authentication, enabling secure access to Google-based features for the virtual assistant.
Utilizes Google Cloud Platform for API access and authentication, supporting the virtual assistant's functionality through Google Cloud services.
Model Context Protocol (MCP)
All credits to : https://github.com/ShawhinT/YouTube-Blog/
Fourth example in AI agents series. Here, I build a customer MCP server to give any AI app access to a toolset for an Artificial Virtual Assistant (AVA).
Links
How to run this example
Clone this repo
Install uv if you haven't already
Test the server in dev mode
Add server config to AI app (e.g. Claude Desktop or Cursor).
Customizing AVA's Behavior
Update Personal Details and Preferences
Locate the
prompts/ava.md
file in your project directoryCustomize the file with:
Communication preferences
Specific instructions for handling tasks
Any other relevant guidelines for AVA
Environment Setup (.env)
Create a
.env
file in the root directory of the project with the following variables:
Required Environment Variables:
USER_EMAIL
: The Gmail address you want to use for this applicationGOOGLE_CREDENTIALS_PATH
: Path to your Google OAuth credentials fileGOOGLE_TOKEN_PATH
: Path where the Google OAuth token will be stored
Google OAuth Setup
1. Create Project Directory Structure
First, create the required directory structure:
2. Set Up Google Cloud Project
Go to the Google Cloud Console
Create a new project or select an existing one
Enable the Gmail API:
In the navigation menu, go to "APIs & Services" > "Library"
Search for "Gmail API"
Click "Enable"
3. Create OAuth Credentials
In the Google Cloud Console:
Go to "APIs & Services" > "Credentials"
Click "Create Credentials" > "OAuth client ID"
Choose "Desktop application" as the application type
Give it a name (e.g., "AVA Gmail Client")
Click "Create"
Download the credentials:
After creation, click "Download JSON"
Save the downloaded file as
credentials.json
in.config/ava-agent/
The file should contain your client ID and client secret
4. Configure OAuth Consent Screen
In the Google Cloud Console:
Go to "APIs & Services" > "OAuth consent screen"
Choose "External" user type
Fill in the required information:
App name
User support email
Developer contact information
Add the Gmail API scope:
https://www.googleapis.com/auth/gmail.modify
Add your email as a test user
Complete the configuration
Signing into Google
Before the server can access you Gmail account you will need to authorize it. You can do this by running uv run oauth.py
which does the following.
Check for the presence of
token.json
If not found, it will initiate the Google OAuth authentication flow
Guide you through the authentication process in your browser:
You'll be asked to sign in to your Google account
Grant the requested permissions
The application will automatically save the token
Generate and store the token automatically
Security Notes
File Protection
Never commit your
.env
file ortoken.json
to version controlKeep your Google credentials secure
Add the following to your
.gitignore
:.env .config/ava-agent/token.json .config/ava-agent/credentials.json
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
Tools
A custom MCP server that provides AI applications with access to an Artificial Virtual Assistant (AVA) toolset, enabling Gmail integration and task management through natural language.
Related MCP Servers
- -securityAlicense-qualityAn MCP server that enables AI assistants to access and interact with Google Classroom data, allowing users to view courses, course details, and assignments through natural language commands.Last updated -6881MIT License
- -securityFlicense-qualityMCP server that enables AI assistants to perform SEO automation tasks including keyword research, SERP analysis, and competitor analysis through Google Ads API integration.Last updated -1
- AsecurityFlicenseAqualityAn MCP server that supercharges AI assistants with powerful tools for software development, enabling research, planning, code generation, and project scaffolding through natural language interaction.Last updated -111,16780