How do I install the groundeffect mcp server?

This profile does not contain a verified copy-paste launch configuration. Follow the current project documentation to confirm the runtime, entry point, transport and authentication before registering it in your client.

What credentials does it need?

It reads `GROUNDEFFECT_GOOGLE_CLIENT_ID`, `GROUNDEFFECT_GOOGLE_CLIENT_SECRET`, `OPENROUTER_API_KEY`, `DATABASE_URL`, `GE_TOKEN_ENCRYPTION_KEY` from the environment. Store these in your client's env block or a secrets manager — never commit them to a repository — and grant the narrowest scope that still covers your use case.

SSyncDev

Start a project

Groundeffect MCP Server

Hyper-fast, local Gmail and Google Calendar indexing for Claude Code.

Local serverstdioGo

What is the Groundeffect MCP Server?

Hyper-fast, local Gmail and Google Calendar indexing for Claude Code.

What the server does

Hybrid Search — BM25 full-text + vector semantic search with Reciprocal Rank Fusion
Local Embeddings — Runs nomic-embed-text-v1.5 locally via Candle with Metal acceleration
Multi-Account — Connect unlimited Gmail/GCal accounts with independent sync
MCP Integration — Exposes email and calendar tools directly to Claude Code
Real-time Sync — IMAP IDLE for instant email notifications, CalDAV polling for calendar
HTML Text Extraction — Automatically converts HTML emails to clean plain text using html2text

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

How to install the Groundeffect MCP Server

{
  "mcpServers": {
    "groundeffect": {
      "type": "stdio",
      "command": "groundeffect-mcp",
      "env": {
        "GROUNDEFFECT_GOOGLE_CLIENT_ID": "${GROUNDEFFECT_GOOGLE_CLIENT_ID}",
        "GROUNDEFFECT_GOOGLE_CLIENT_SECRET": "YOUR_GROUNDEFFECT_GOOGLE_CLIENT_SECRET"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

Variable	Description	Required
GROUNDEFFECT_GOOGLE_CLIENT_ID	Declared in the maintainer’s client configuration.	Check documentation
GROUNDEFFECT_GOOGLE_CLIENT_SECRET	Declared in the maintainer’s client configuration.	Check documentation

Frequently asked questions

Hyper-fast, local Gmail and Google Calendar indexing for Claude Code. Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.