Skip to main content
ACE3 LogoACE3
Public BetaWe're in Public Beta. Things may break. Please report issues via the Support tab.
Back to Setup Guide

Google Gemini Setup

Configure ACE MCP with Google Gemini CLI tools and AI Studio - Complete step-by-step guide.

Prerequisites
1

Node.js 18+ installed

Check with: node --version

2

Gemini CLI installed

3

Google AI API key configured

Get API key from AI Studio →

4

ACE CLI installed and logged in

5

ACE server running

MCP Support in Gemini

Google Gemini supports MCP (Model Context Protocol) for integrating external tools. This allows Gemini models to access ACE's memory infrastructure seamlessly for persistent context across conversations.

1
Create MCP Config File

Create the Gemini MCP configuration file at the appropriate location for your operating system:

Config file location:

Create directory if needed: mkdir -p ~/.gemini

2
Add ACE Configuration

Add the ACE MCP server to your config file:

Important: Customize Your Namespace

Replace my-project with a unique namespace for your project.

3
Run Gemini CLI

Start the Gemini CLI in your project directory:

4
Test ACE Integration

Try these prompts to verify the ACE connection:

Store a memory:

"Remember that we're using Firebase for authentication"

Track a decision:

"Track a decision: switching from REST to GraphQL"

Query issues:

"What issues are currently open in this project?"

Success!

If Gemini responds by using ACE tools, your setup is complete!

Alternative: Using with Google AI Studio

For Google AI Studio web interface, you can integrate ACE via the REST API directly:

  1. Create a custom function that calls ACE's REST API
  2. Register the function with your Gemini model
  3. The model can now store and retrieve context from ACE

Example: Store memory via REST API

Troubleshooting

"ace: command not found"

The ACE CLI is not in your PATH. Try these fixes:

  1. Reinstall ACE globally: npm install -g @ace3-memory/ace
  2. Check npm global bin: npm bin -g
  3. Add to PATH in your shell config file
ACE tools not appearing
  1. Verify ACE server is running: ace status
  2. Check config file for JSON syntax errors
  3. Restart Gemini CLI after config changes
  4. Verify the config file path is correct

Available ACE Tools

Once configured, Gemini can use these 20+ ACE tools:

ace_rememberace_recallace_get_contextace_searchace_track_issueace_resolve_issueace_find_solutionsace_track_decisionace_best_practicesace_get_statsace_log_workace_architectureace_patternsace_manage_tagsace_graph_connectace_graph_traverseace_create_planace_generate_planace_observe

Next Steps