Google Gemini
Google Gemini has native MCP support, so connecting it to Basic Memory takes a single command.
Cloud Setup
No local install needed -- Basic Memory Cloud gives you hosted MCP access.
Sign Up
Create your account at app.basicmemory.com.
Add the Remote MCP Server
gemini mcp add -t http basic-memory-cloud https://cloud.basicmemory.com/mcp
Authenticate
Follow the OAuth flow to grant Gemini access to your Basic Memory account.
Verify
gemini mcp list
You should see basic-memory-cloud with Connected status.
Local Setup
Video Tutorial
Watch this quick guide to get started with Basic Memory and Google Gemini:
Configure Gemini
Install
gemini mcp add basic-memory bash -c "uvx basic-memory mcp"
Verify
gemini mcp list
You should see basic-memory listed with Connected status.
gemini mcp add basic-memory bash -c "uvx basic-memory mcp --project your-project-name"
-s user flag:gemini mcp add -s user basic-memory bash -c "uvx basic-memory mcp"
Try It
Once Gemini is connected, give these a spin:
Save a decision
"Create a note about our decision to use JWT-based auth for the API,
including the trade-offs we discussed."
Pick up where you left off
"What have I been working on this week? Check recent activity."
Semantic search
"Search my notes for anything related to database migration strategies."
For the full list of available tools, see the MCP Tools Reference.
Troubleshooting
Gemini can't find Basic Memory -- Verify it's installed (basic-memory --version), then check gemini mcp list. If the entry looks wrong, remove and re-add it:
gemini mcp remove basic-memory
gemini mcp add basic-memory bash -c "uvx basic-memory mcp"
memory:// URLs not resolving -- Make sure the note exists in your current project and that sync is running (basic-memory status).
Notes not updating -- Check file permissions in your knowledge base directory and look for errors in ~/.basic-memory/logs.