FreeHow credits work →

Research tools for Gemini CLI

Run gemini mcp add once, then /mcp auth. Gemini CLI can then pull weather records, earthquake catalogues, star and exoplanet tables and open datasets from the terminal.

How to connect ScholarMuse to Gemini CLI

One command in a terminal and one command inside Gemini CLI. You can also paste “Read https://scholarmuse.ai/install/agent.md and follow the instructions to connect ScholarMuse” into Gemini CLI and let it run the first command.

Full connect guide →
  1. Step 1

    Add the server

    Run this in a terminal. With --scope user the entry is saved in ~/.gemini/settings.json and applies in every folder; without it, Gemini CLI saves the entry for the current project only.

    gemini mcp add --transport http --scope user scholarmuse https://scholarmuse.ai/mcp
  2. Step 2

    Start the sign-in

    Start gemini and type this command. It begins the browser sign-in for the server you just added.

    /mcp auth scholarmuse
  3. Step 3

    Approve in your browser

    A scholarmuse.ai window opens. Sign in, approve access and choose which discipline packs Gemini CLI may use. There is no API key to create or paste.

  4. Step 4

    Check that it works

    Type /mcp to see the server and its tools, then ask Gemini CLI to list the ScholarMuse capabilities.

What Gemini CLI can fetch once connected

Gemini CLI runs in a terminal beside your scripts, so the list leads with observational data from earth science and astronomy that goes straight into an analysis.

Historical weather data for any place
Daily temperature, precipitation, wind and solar radiation for a field site, by coordinates, back to 1981.
Earthquake & water data
A USGS event list for a region and magnitude range, or the readings of a stream gauge, without writing the query by hand.
Exoplanets & stars
Tables from the NASA Exoplanet Archive and the Gaia catalogue, selected by the criteria you state in a sentence.
Species occurrence
GBIF occurrence records to set beside climate data for the same area.
Find datasets
When no live source covers your question, search the data repositories for a published dataset with a licence you can use.
Economic & social statistics
Official series for the human side of an environmental study, such as population or energy use.
Search papers
Check how published studies handled the same data before you settle on a method.

Things to ask Gemini CLI

Earthquake & water data

You say to your agent

Use ScholarMuse to list M4.5+ earthquakes within 200 km of Kathmandu from 2015 to 2025, save them as quakes.csv and print the count per year.

A USGS event list with time, location, depth and magnitude that Gemini CLI writes to a file and counts.

Exoplanets & stars

You say to your agent

From the NASA Exoplanet Archive, get confirmed planets with both mass and radius measured, and write a Python script that plots the mass–radius diagram.

A table of planets with the requested columns and their source, ready for the plotting script.

Historical weather data for any place

You say to your agent

Get daily precipitation for 1.29 S, 36.82 E from 1991 to 2020 and compute the mean rainfall for each calendar month.

A daily series with units from NASA POWER, which Gemini CLI aggregates by month.

Frequently asked questions

The sign-in needs a web browser on the machine where Gemini CLI runs. Its documentation says OAuth does not work in headless environments, in remote SSH sessions without X11 forwarding, or in containers without a browser. Connect on your own computer, fetch the data there and copy the files to the server.

The default scope is the project: the entry goes into .gemini/settings.json in the current folder and only applies there. With --scope user it goes into ~/.gemini/settings.json and ScholarMuse is available wherever you start gemini.

Run gemini mcp remove scholarmuse in a terminal; gemini mcp list shows what is configured. You can also disconnect the agent from your ScholarMuse account.

They are separate. However you sign in to Gemini CLI itself, ScholarMuse has its own browser sign-in at scholarmuse.ai and no API key. A new ScholarMuse account gets 50 credits once.

Every call your agent makes uses credits, and a call is charged only when it succeeds. There are no subscriptions. A new account starts with a one-time gift of 50 credits. The 6 web tools under /tools are free without an account, up to 5 runs a day.

Requests are used only to answer you. We do not train models on them.

Ready to make your agent a better scholar?

Connect once. Papers, data and figures from 50+ sources, in the agent you already use.

Works with compatible AI agents

ClaudeChatGPTCodexCursorWorkBuddyTraeGemini CLIAntigravityQoderCodeBuddyKimi CodeQwen CodeClineKiroWindsurfZedOpenCodeOpenClawDifyCherry StudioLM StudioGooseAmpContinueRoo CodeVS CodeJetBrainsWarpRaycastCopilotPerplexityAny MCP client

Data from OpenAlex · Crossref · PubMed · arXiv · NIH · UniProt · PDB · PubChem · NASA · World Bank · USGS · GBIF and more