MCP Server

What is Model Context Protocol (MCP)?

Model Context Protocol (MCP) is a custom MCP server that gives any AI application access to a toolset for an Artificial Virtual Assistant (AVA). It integrates with Gmail via Google OAuth, allowing the assistant to read and send emails. This server is designed for developers building AI agents with email capabilities.

How to use Model Context Protocol (MCP)?

Clone the repo, install uv, then test the server with uv run mcp dev mcp-server-example.py. Add the server configuration to an AI app (e.g., Claude Desktop or Cursor) using the provided JSON config. Customize the assistant’s behavior by editing prompts/ava.md, set up a .env file with your Google OAuth credentials, and authorize Gmail access by running uv run oauth.py.

Key features of Model Context Protocol (MCP)

• Integrates with Gmail via Google OAuth
• Customizable assistant personality and preferences
• Testable in dev mode with uv run mcp dev
• Compatible with Claude Desktop and Cursor
• Secure credential and token management
• Simple setup with uv package manager

Use cases of Model Context Protocol (MCP)

• Building an AI virtual assistant with email capabilities
• Automating email tasks like reading and sending messages
• Creating agentic workflows that run on desktop AI apps
• Personalizing assistant behavior for specific user preferences