This guide walks you through connecting the Tekst MCP server to Gemini CLI. Once connected, Gemini can use Tekst tools to retrieve process mining data, analytics, automation history, and more.
Before you begin
A Tekst admin must enable MCP access for your workspace first. In Tekst, go to Settings > Security, find the Model Context Protocol (MCP) section, and turn on Enable Model Context Protocol (MCP). Users cannot connect until this setting is on.
Once MCP is enabled, each user still needs to add the Tekst server to their Gemini CLI configuration and authenticate with their own Tekst credentials.
Prerequisites
Before connecting, make sure you have:
- An active Tekst account with access to the workspace you want to connect
- Gemini CLI installed and signed in
- MCP enabled in your Tekst workspace (see above)
Tekst MCP server URL
The Tekst MCP server is available at:
https://mcp.tekst.com
The server uses the Streamable HTTP transport and supports OAuth 2.0 with dynamic client registration, so Gemini CLI can discover the required endpoints automatically.
Connect Tekst to Gemini CLI
There are two ways to register the Tekst MCP server: a one-line command, or editing your settings file directly.
Option 1: Add via the gemini mcp add command
- Open your terminal and run:
gemini mcp add tekst --httpUrl https://mcp.tekst.com
-
Start Gemini CLI by running
geminiin your terminal. -
Type
/mcpto view the configured servers. Tekst appears in the list with a status indicating it needs authentication. -
Run
/mcp auth tekstand follow the prompts. Your browser opens the Tekst login page - sign in with your Tekst credentials and authorize access. -
Once authenticated,
/mcpshows Tekst as connected and lists the available tools.
Option 2: Edit settings.json manually
If you prefer to manage your Gemini configuration directly, add Tekst to the mcpServers block in ~/.gemini/settings.json (user scope) or .gemini/settings.json (project scope):
{
"mcpServers": {
"tekst": {
"httpUrl": "https://mcp.tekst.com"
}
}
}
After saving the file, start Gemini CLI and run /mcp auth tekst to complete the OAuth flow.
Managing the connection
Gemini CLI provides several /mcp subcommands to manage your servers:
-
/mcp- List all configured MCP servers, their status, and the tools they expose -
/mcp auth tekst- Start or refresh the OAuth login for Tekst -
/mcp disable tekst- Temporarily disable the Tekst server without removing it -
/mcp enable tekst- Re-enable the Tekst server
To remove the integration entirely, run gemini mcp remove tekst or delete the tekst entry from your settings.json.
Authentication and security
The Tekst MCP integration uses OAuth 2.0 with PKCE for secure authentication. When you connect, you sign in through the standard Tekst login page - your credentials are never shared with Gemini.
Key security details:
- Gemini receives a scoped access token that only allows read access to your workspace
- Your session is tied to a single workspace and cannot access other workspaces
- Sessions expire after 30 minutes of inactivity
- You can disconnect at any time with
/mcp disable tekstor by removing the server from your settings
What happens after connecting
Once connected, you can ask Gemini questions about your Tekst workspace in natural language. For example:
- "What processes do I have in Tekst?"
- "Show me the automation execution history for my email routing flow"
- "How many tickets were processed last week?"
Gemini will use the Tekst MCP tools to retrieve the relevant data and answer based on your actual workspace.
Troubleshooting
/mcp does not show Tekst
Confirm that the tekst entry was written to the correct settings.json (user-scope at ~/.gemini/settings.json or project-scope at .gemini/settings.json). Restart Gemini CLI after editing the file.
Authentication fails in the browser
- Make sure your default browser is set correctly and pop-ups are allowed.
- Check that no firewall or proxy is blocking the connection to
mcp.tekst.com. - Run
/mcp auth tekstagain to restart the flow.
Tools are missing or return empty results
See the Tekst MCP Troubleshooting guide for general MCP troubleshooting, including session expiry, permission errors, and analytics query issues.
For additional help, contact Tekst support at support@tekst.com.