Eulerian MCP Integration Guide for Gemini CLI
EULERIAN MCP
Integration Guide with Gemini CLI
Step-by-step, no prior experience needed | ~15–20 minutes | Gemini CLI
1. What is the Eulerian MCP
The Eulerian MCP is a connector that lets your AI assistant read your Eulerian Marketing Platform data directly. Instead of opening dashboards or exporting files, you simply ask questions in plain language. This guide sets it up with Gemini CLI, a free assistant from Google that runs in a “terminal” window.
Don’t want to use a terminal? Claude Desktop offers a one-click installer with no commands at all. If you’re not comfortable typing commands, that may be the easier option. This guide is specifically for Gemini CLI.
2. Before you begin
You’ll need these five things. Don’t worry about the technical ones — the steps below show you exactly what to do.
- 1 · An Eulerian account (Webmaster type). If you don’t have one, ask your platform administrator.
- 2 · Your Eulerian API token. A secret text string provided by Eulerian. Keep it somewhere safe; you’ll paste it in Step 4.
- 3 · Your Eulerian endpoint URL. Looks like https://something.api.eulerian.com/mcp . Also provided by Eulerian.
- 4 · Python and Node.js installed. Free downloads: Python from python.org/downloads (on Windows, tick “Add Python to PATH” during install), and Node.js from nodejs.org .
- 5 · A free Google account, to create a Gemini API key in Step 5.
3. How to open the terminal (you’ll use it several times)
The “terminal” is a window where you type commands. Opening it:
- Windows: press the Windows key, type cmd, and press Enter. A black window opens — that’s the terminal.
- macOS: press Cmd + Space, type Terminal, press Enter.
- Linux: open your Terminal application.
How to use it: click inside the window, type (or paste) a command, then press Enter to run it. To paste in the Windows terminal, use right-click (Ctrl+V may not work). You can keep this window open and reuse it for every step.
4. Step-by-step setup
Step 1 Install Gemini CLI
Open the terminal (section 3). Type this line and press Enter (it may take a minute):
npm install -g @google/gemini-cli
When it finishes, check it worked by typing:
gemini --version
If you see a version number, you’re good. (If it says “not recognised”, close the terminal, open a new one, and try again.)
Step 2 Install the Eulerian connector
In the same terminal, type:
pip install eulerian-marketing-platform
You should end with a line like “Successfully installed eulerian-marketing-platform”.
Step 3 Find your Python path (write it down)
Gemini needs the exact location of Python on your computer. In the terminal, type:
python -c "import sys; print(sys.executable)"
It prints one line, for example:
C:\Users\you\AppData\Local\Programs\Python\Python312\python.exe
Copy that whole line and keep it handy — you’ll paste it in Step 4. To copy in the Windows terminal: drag-select the text with the mouse, then press Enter. (If the line contains WindowsApps, install Python from python.org and run this again.)
Step 4 Create and edit the configuration file
This file tells Gemini to use Eulerian. It’s named settings.json and lives in a folder called .gemini. Here’s exactly how to find or create it.
4a. Open the folder.
Open File Explorer (the yellow folder icon, or press Windows key + E).
Click the address bar at the top, type exactly %USERPROFILE%\.gemini and press Enter.
If it says the folder doesn’t exist: type %USERPROFILE% instead, press Enter, then right-click → New → Folder and name it exactly .gemini, then open it.
4b. Turn on file extensions (so the file isn’t secretly a .txt).
In File Explorer, open the View menu → Show → tick File name extensions. Now files show their real ending, like .json or .txt.
4c. Create the file (skip if a settings.json is already there).
Right-click an empty area → New → Text Document.
Rename it to exactly settings.json (delete the .txt ending). Click Yes on the warning.
4d. Open the file and paste the content.
Right-click settings.json → Open with → Notepad.
Delete anything inside, then paste exactly this:
{"mcpServers": {"eulerian-marketing-platform": {"command": "PASTE-YOUR-PYTHON-PATH-HERE","args": ["-m", "eulerian_marketing_platform.server"],"timeout": 600000,"env": {"EMP_API_ENDPOINT": "PASTE-YOUR-EULERIAN-URL-HERE","EMP_API_TOKEN": "PASTE-YOUR-TOKEN-HERE"}}}}
4e. Replace the three PASTE-... placeholders with your own values (keep the quotes "" around each one):
- "command": your Python path from Step 3.
- "EMP_API_ENDPOINT": your Eulerian URL (item 3 of “Before you begin”).
- "EMP_API_TOKEN": your Eulerian token (item 2).
Windows — very important about the Python path: change every single backslash \ into a double backslash \\. For example, this:C:\Users\you\...\python.exemust be typed as:C:\\Users\\you\\...\\python.exe
Then save the file: press Ctrl+S. The settings file location, for reference:
Windows
%USERPROFILE%\.gemini\settings.json
macOS
~/.gemini/settings.json
Linux
~/.gemini/settings.json
Step 5 Get and set your Gemini API key
This is a free key that lets Gemini answer (it is separate from your Eulerian token).
In a browser, open https://aistudio.google.com/apikey and sign in with Google.
Click Create API key, then Copy it (it starts with AIza or similar).
Back in the terminal, type set GEMINI_API_KEY= and then right-click to paste your key right after the =, and press Enter:
set GEMINI_API_KEY=your-key-pasted-here
(macOS/Linux: use export GEMINI_API_KEY=your-key instead.)
Step 6 Start Gemini and check the connection
In the same terminal window, type gemini and press Enter.
If it asks about trusting the folder, choose “Trust folder”. If it asks how to authenticate, choose “Use Gemini API key”.
Type /mcp list and press Enter. After a few seconds the Eulerian server should show as Ready, with a list of tools:
What success looks like: the Eulerian server is “Ready” with its tools listed.
Step 7 Try it
Ask Gemini in plain language, for example: “Which websites can I query with my Eulerian account?” The first time, it will ask permission to run a tool — say yes. When you see your real data, you’re done.
5. How to use it — example questions
- How did our paid search campaigns perform last week?
- Which channels contributed most to conversions this month?
- Compare campaign cost vs. revenue this month vs. last month.
- What Eulerian tools do you have available?
Tip: be specific. “What is the CPA of our display campaigns last month?” works far better than “how are campaigns doing?”.
6. Security
- Keep your token and key private. They’re like passwords — don’t share them, don’t put them in screenshots or emails. If one is ever seen by someone else, create a new one.
- Check with your IT team before using real business data with any AI tool.
- Double-check important numbers in the Eulerian interface; AI can occasionally phrase a query imperfectly.
7. If something doesn’t work
“gemini” is not recognised
Close the terminal and open a new one. Still failing? Type npx @google/gemini-cli instead of gemini.
“python” is not recognised
Server shows “Disconnected” on the first try
Tool discovery can take 20–30 seconds. Wait a moment and run /mcp list again. The "timeout" line in Step 4 also helps.
Still “Disconnected”, and you suspect the Python path
Re-check Step 4: the command must be your exact Python path with double backslashes (\\).
“Usage limit reached”
That is your Gemini model quota, not Eulerian. Type /model to switch model, or wait for it to reset.
Sign-in says “no longer supported / Antigravity”
Use a Gemini API key instead (Step 5). The free Google sign-in no longer works in the CLI.
8. Useful links
- Eulerian connector (GitHub): github.com/EulerianTechnologies/eulerian-marketing-platform-mcp
- Gemini API keys: aistudio.google.com/apikey
- Install Python: python.org/downloads
- Install Node.js: nodejs.org