Skip to main content

How do I connect Gemini to Projul?

Hunter Kiepke
Updated

Gemini CLI connects to Projul today with one command. The Gemini app and Gemini Enterprise only add outside tools through OAuth sign-in, which Projul AI Connect does not support, so neither one connects.

Before you start

You need Gemini CLI installed and signed in, and your Projul AI Connect API key. If you have not created a key yet, see How do I get my Projul AI Connect API key?.

Connect Gemini CLI

To add Projul, follow these steps.

  1. Open a terminal.
  2. Run the command below, replacing prjl_live_YOURKEYHERE with your key. Keep the quotes.
gemini mcp add --scope user --transport http --header "Authorization: Bearer prjl_live_YOURKEYHERE" projul https://connect.projul.com/mcp

The "--scope user" part makes Projul available in every folder you open Gemini CLI in. Gemini CLI writes the entry into settings.json in the.gemini folder in your home directory, or you can edit that file directly with an entry like this.

{
 "mcpServers": {
 "projul": {
 "httpUrl": "https://connect.projul.com/mcp",
 "headers": {
 "Authorization": "Bearer prjl_live_YOURKEYHERE"
 }
 }
 }
}

Note: The key is stored in that file on your computer. Do not share the file or commit it to a shared code repository.

Check it and use it

Start Gemini CLI and type /mcp to see the connected servers and the Projul tools. Then ask in plain English.

What clients do I have in Projul? Just list their names.

Gemini asks you to approve a Projul tool the first time it uses one. Gemini CLI can only do what your key allows: a Read key lets it look at your data, and a Read-Write key also lets it create and change things such as leads, estimates and tasks. See Should I give my AI a Read key or a Read-Write key?.

The

The Gemini app and Gemini Enterprise

The Gemini app can add a custom app by its MCP address, under "Settings & help", "Connected Apps", "Custom apps for Spark", for accounts with Gemini Spark. That option signs in with OAuth and gives you no place to paste an API key, so it cannot reach Projul.

An administrator can add a custom MCP server to Gemini Enterprise under "Connected apps", but it also signs in only with OAuth, asking for an authorization address, a token address and a client id. Projul AI Connect uses API keys, so neither can be added.

See the "Connect your AI" section.

Questions? Let's Chat.
support@projul.com
(844) 776-5853

Powered by Zendesk