MCP Server Setup Instructions

by amirdhs

96 downloads
Not rated
GitHub

Description

# MCP Server Setup Instructions This MCP server provides a Telegram AI agent that can interact with Gmail, Google Calendar, and Google Tasks using the Ionos AI model. ## Prerequisites 1. Python 3.8 or higher 2. Google Cloud Project with APIs enabled 3. Telegram Bot Token 4…

About

# MCP Server Setup Instructions This MCP server provides a Telegram AI agent that can interact with Gmail, Google Calendar, and Google Tasks using the Ionos AI model. ## Prerequisites 1. Python 3.8 or higher 2. Google Cloud Project with APIs enabled 3. Telegram Bot Token 4. Ionos AI API Key ## Step 1: Install…

Details

Author
amirdhs
Downloads
96
Categories
Other

- Send messages via Telegram
- Search Gmail messages
- Create Google Calendar events
- Create Google Tasks
- Chat with Ionos AI model

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 MCP Server Setup Instructions
    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

What dependencies are required?

Python 3.8+, a Google Cloud project with Gmail, Calendar, and Tasks APIs enabled, a Telegram bot token from BotFather, and an Ionos AI API key.

How are credentials stored and secured?

Google OAuth2 credentials are stored in credentials.json and the authentication token in token.pickle. Both files are sensitive and should not be committed to version control. The .env file holding keys must also be kept secure.

What are the API rate limits?

Gmail: 1 billion quota units per day; Calendar: 1 million requests per day; Tasks: 50,000 requests per day; Ionos AI: depends on your plan.

Why is the Telegram bot not responding?

Check your bot token and network connection. Ensure the server is running and the bot is initialized with /start.

How do I fix authentication failures?

Verify your Google OAuth2 credentials are correct and re‑run authentication by deleting token.pickle and starting the server again.

Claude Desktop / Cursor

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

{
    "mcpServers": {
        "mcp server setup instructions": {
            "mcp-server-amirdhs": {
                "command": "python",
                "args": [
                    "mcp_server.py"
                ]
            }
        }
    }
}

McpServers

{
    "mcp-server-amirdhs": {
        "command": "python",
        "args": [
            "mcp_server.py"
        ]
    }
}

MCP Server Setup Instructions

This MCP server provides a Telegram AI agent that can interact with Gmail, Google Calendar, and Google Tasks using the Ionos AI model.

Prerequisites

1. Python 3.8 or higher
2. Google Cloud Project with APIs enabled
3. Telegram Bot Token
4. Ionos AI API Key

Step 1: Install Dependencies

pip install -r requirements.txt

Step 2: Google Cloud Setup

1. Go to Google Cloud Console
2. Create a new project or select existing one
3. Enable the following APIs:
- Gmail API
- Google Calendar API
- Google Tasks API
4. Create OAuth2 credentials:
- Go to "Credentials" → "Create Credentials" → "OAuth client ID"
- Choose "Desktop application"
- Download the JSON file and rename it to credentials.json
- Place it in the same directory as your script

Step 3: Telegram Bot Setup

1. Message @BotFather on Telegram
2. Use /newbot command to create a new bot
3. Follow the instructions and get your bot token
4. Copy the token to your .env file

Step 4: Ionos AI Setup

1. Get your API key from Ionos AI service
2. Add it to your .env file

Step 5: Environment Configuration

1. Copy .env.example to .env
2. Fill in all the required values:

```bash
cp .env.example .env

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.