filopedraz
MCP Serverfilopedrazpublic

carlitos

🎾 Carlitos 🧙‍♂️ The MCP Client of the MCP Clients... alias Megabot

Repository Info

0
Stars
0
Forks
0
Watchers
14
Issues
Python
Language
MIT License
License

About This Server

🎾 Carlitos 🧙‍♂️ The MCP Client of the MCP Clients... alias Megabot

Model Context Protocol (MCP) - This server can be integrated with AI applications to provide additional context and capabilities, enabling enhanced AI interactions and functionality.

Documentation

Carlitos

Carlitos is Filippo's personal assistant inspired by Carlos Alcaraz (the tennis player) even if obviously Sinner is stronger.

Running Carlitos...

Create an mcp.json file in this format

{
    "mcpServers": {
        "sequential-thinking": {
            "command": "npx",
            "args": [
                "-y",
                "@modelcontextprotocol/server-sequential-thinking"
            ],
            "description": "Handles multi-step reasoning tasks and complex problem solving requiring sequential thinking"
        },
        "Puppeteer": {
            "command": "npx",
            "args": [
                "-y",
                "@modelcontextprotocol/server-puppeteer"
            ],
            "description": "Provides web automation and browser interaction capabilities"
        },
        "gmail_composio": {
            "url": "",
            "description": "Manages Gmail operations including sending, reading, and organizing emails"
        },
        "calendar_composio": {
          "url" : "",
          "description": "Handles calendar operations including creating, updating, and scheduling events"
        },
        "notion_composio": {
            "url": "",
            "description": "Manages Notion workspace operations including pages, databases, and content"
        },
        "slack_composio": {
            "url": "",
            "description": "Facilitates Slack messaging and channel management operations"
        },
        "linear_composio": {
            "url": "",
            "description": "Manages Linear issue tracking and project management operations"
        }
    }
}

Check in the FAQs how to generate the composio URLs for the integrations.

Vamos Carlitos

# first we need to run all the MCP servers
docker compose up -d

# then we can run Carlitos
virtualenv venv
source venv/bin/activate
pip install -r requirements.txt
python main.py

Remember to set the OPENAI_API_KEY environment variable in your .env file.

FAQs

  • What Carlitos can do? Idk... many things. All the possible actions related to Calendar, Gmail, Slack, Notion, Linear and GitHub.

  • What Carlitos will be able to do? Imagination is the limit.

  • How to create the correct MCP configuration file? Better if you ask Filippo... In order to quickly integrate with all the providers, the easiest and quickest solution it's to use Composio. Composio exposes a MCP server for each of the providers.

  • Which integrations does Carlitos support right now? Google Calendar, Gmail, Slack, Notion, Linear, and GitHub

  • Why not the other integrations? I don't care... Carlitos has been built with the only purpose of serving Filippo. If you want to add a new integration, you can do it by yourself.

Quick Start

1

Clone the repository

git clone https://github.com/filopedraz/carlitos
2

Install dependencies

cd carlitos
npm install
3

Follow the documentation

Check the repository's README.md file for specific installation and usage instructions.

Repository Details

Ownerfilopedraz
Repocarlitos
LanguagePython
LicenseMIT License
Last fetched8/10/2025

Recommended MCP Servers

💬

Discord MCP

Enable AI assistants to seamlessly interact with Discord servers, channels, and messages.

integrationsdiscordchat
🔗

Knit MCP

Connect AI agents to 200+ SaaS applications and automate workflows.

integrationsautomationsaas
🕷️

Apify MCP Server

Deploy and interact with Apify actors for web scraping and data extraction.

apifycrawlerdata
🌐

BrowserStack MCP

BrowserStack MCP Server for automated testing across multiple browsers.

testingqabrowsers

Zapier MCP

A Zapier server that provides automation capabilities for various apps.

zapierautomation