Multi-server MCP AI Agent

by IsaacDsouza

201 downloads
Not rated
GitHub

About

Agentic AI platform that automates personal tasks by integrating with services such as Gmail, Notion, Slack, Zoom, and Google Drive via a modular tool marketplace. MCP, LangChain, MongoDB, Python

Details

Author
IsaacDsouza
Downloads
201
Categories
AI

- Automates meetings, emails, and docs via prompts
- Integrates multiple MCP servers for orchestration
- Uses Google OAuth 2.0 for secure Gmail access
- Local installation with Python virtual environment
- Global credential storage in ~/.gmail-mcp/

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Multi-server MCP AI Agent
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Clone the repository, set up a Python virtual environment with uv, install dependencies, create a Google Cloud project and enable the Gmail API, generate OAuth 2.0 credentials, run the authentication process via npx, execute the token generator script, and finally run the application with uv run app.py.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "multi-server mcp ai agent": {
            "mcp-with-multiple-servers": {
                "command": "uv",
                "args": [
                    "venv"
                ]
            }
        }
    }
}

McpServers

{
    "mcp-with-multiple-servers": {
        "command": "uv",
        "args": [
            "venv"
        ]
    }
}

Multi-server MCP AI Agent

Automates your meetings, emails & docs via prompts

Setup Steps

1. # Clone and enter the project

git clone https://github.com/IsaacDsouza/mcp-with-multiple-servers
cd mcp-with-multiple-servers

2. # Create virtual environment and activate it

  uv venv
.venv\Scripts\activate

3. # Install dependencies:

uv add -r requirements.txt

4. # Create a Google Cloud Project and obtain credentials:

a. Create a Google Cloud Project:
- Go to Google Cloud Console
- Create a new project or select an existing one
- Enable the Gmail API for your project

b. Create OAuth 2.0 Credentials:
- Go to "APIs & Services" > "Credentials"
- Click "Create Credentials" > "OAuth client ID"
- Choose either "Desktop app" or "Web application" as application type
- Give it a name and click "Create"
- For Web application, add http://localhost:3000/oauth2callback to the authorized redirect URIs
- Download the JSON file of your client's OAuth keys
- Rename the key file to gcp-oauth.keys.json

5. # Run Authentication:

You can authenticate in two ways:

a. Global Authentication (Recommended):

   # First time: Place gcp-oauth.keys.json in your home directory's .gmail-mcp folder
mkdir -p ~/.gmail-mcp
mv gcp-oauth.keys.json ~/.gmail-mcp/

# Run authentication from anywhere
npx @gongrzhe/server-gmail-autoauth-mcp auth

b. Local Authentication:

   # Place gcp-oauth.keys.json in your current directory
# The file will be automatically copied to global config
npx @gongrzhe/server-gmail-autoauth-mcp auth

The authentication process will:
- Look for gcp-oauth.keys.json in the current directory or ~/.gmail-mcp/
- If found in current directory, copy it to ~/.gmail-mcp/
- Open your default browser for Google authentication
- Save credentials as ~/.gmail-mcp/credentials.json

> Note:
> - After successful authentication, credentials are stored globally in ~/.gmail-mcp/ and can be used from any directory
> - Both Desktop app and Web application credentials are supported
> - For Web application credentials, make sure to add http://localhost:3000/oauth2callback to your authorized redirect URIs

6. # Run Token generator:

uv run tokengen.py

7. # Run Application
uv run app.py

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.