claudeers.
// MCP Servers

gglint

Keeps the MCP servers of Claude Code, Codex, Cursor, Gemini CLI and other coding agents in sync

// MCP Servers[ cli ][ api ][ claude ]#claude#mcp-servers◷ Apache-2.0$open-sourceupdated 3 days ago

Install with your AI

Paste into Claude Code, Cursor, or any agent — it reads the repo and wires the tool into your project.

Install and set up gglint (pip project) into my current project.
Found on https://claudeers.com/gglint
Repo: https://github.com/corridor/gglint
Homepage/docs: —
Detected install method: pip → pip install gglint
Category: mcp-servers. Platforms: cli, api.
Read the repo's README for exact setup and env vars, then install it and wire it into my project.

Claudeers Health Verdict:
unknown; community-verified: false. Confirm the source before running anything.
// or install directly (pip)
pip install gglint
// or clone
git clone https://github.com/corridor/gglint

// compatibility

Platformscli, api
Operating systems—
AI compatibilityclaude
LicenseApache-2.0
Pricingopen-source
LanguageRust

Get your FREE $2.50 API credits to access TickAtlas financial data ↗

gglint

Keep the MCP servers of every coding agent in your repository in sync.

Claude Code, Codex, Cursor, Gemini CLI, Copilot CLI and nine other coding agents each read MCP servers from their own config file, in their own format (see Supported agents). In a repository set up for more than one of them, those files drift apart: a server is added to .mcp.json but not to .cursor/mcp.json, a version is pinned in one file and not the other, or an agent has no MCP config at all. gglint finds every difference and fixes it for you, written in each agent's own format.

A terminal running uvx gglint mcp: it draws each MCP server in Claude Code, Codex, Cursor and OpenCode as a table, then lists six problems: missing servers, a server set up differently, and an agent without a config file

Click the terminal to open it on its own, then hover over a server, an agent, a cell or a problem to see what gglint found there and what --fix does about it. The same details are in this table, on hover:

ServerClaude CodeCodexCursorOpenCode
github✓✗✗✗
playwright✓✗≠✗
linear✗✗✓✗
  • One view of every agent. A table shows which agent gets which server, and how each one differs.
  • One fix. --fix adds the missing servers and config files and starts each server the same way in every agent. It never removes a server, and keeps your comments and formatting.
  • Each agent's own format. A server is translated between JSON and TOML, between each agent's syntax for environment variables, and between local and remote server types.
  • Fast and read-only by default. gglint reads a few files at fixed paths and typically finishes in under a millisecond. It never starts a server or downloads anything.
  • Built for CI. It exits with status 1 when it finds a problem, and --format lines prints one problem per line.

In November 2026 we checked the 258 most-starred GitHub repositories set up for two or more of Claude Code, Codex, Cursor and OpenCode. Of the 179 that configure MCP servers, 128 (72%) had at least one of the problems gglint reports. Among the 166 active repositories with 30 or more stars that set up a newer agent, such as Gemini CLI, Kiro or Junie, 83 of the 162 with MCP servers (51%) had at least one problem.

Quick start

gglint runs with uvx, which comes with uv. If uvx isn't on your machine, install uv with its installation guide first.

From the root of a repository, run these three commands in order:

uvx gglint mcp
uvx gglint mcp --fix
git diff

The first reports every problem, the second fixes them, and the third shows what changed. uvx downloads gglint the first time and reuses it afterwards; there's nothing else to install. It works on Linux, macOS and Windows.

Usage

uvx gglint mcp [--fix] [--source AGENT] [--format table|lines] [PATH]
uvx gglint mcp --servers [PATH]
OptionEffect
(none)Report every problem and draw each server in each agent.
--fixAdd missing servers and config files, start each server the same way, then report what's left.
--source AGENTTake each server's setup from AGENT where it has the server. AGENT is a name from the --source column of Supported agents, such as claude-code or gemini-cli.
--format linesPrint one line per problem instead of the table, for editors and CI.
--serversList every configured server, file by file, without comparing them.
PATHThe repository's root. Defaults to the current directory.
Exit statusMeaning
0Every agent gets the same servers, set up the same way.
1gglint found a problem, one is left after --fix, or there are no MCP config files.

Colours are used when standard output is a terminal and NO_COLOR isn't set. The summary line, with counts and timing, goes to standard error.

What gglint checks

RuleReported whenFixed by
missing-serverA server in one agent's config file is missing from another agent's.--fix
missing-configAn agent has its own directory but no MCP config file, while other agents have servers.--fix
different-serverThe same server runs another version or has other arguments.--fix
The same server runs another program or URL, has other environment variables or headers, or is turned off in one agent.Reported only
renamed-serverThe same server has a different name in some agents.Reported only

--fix makes the command lines match, since the same server should normally start the same way everywhere. The other differences can be deliberate, such as each agent setting its own environment variables, so gglint reports them and leaves them to you.

Matching servers. Servers are matched by name, then by what they run, so a server named differently in one agent is still recognised as the same server. The way a package is launched doesn't count as a difference:

  • npx -y pkg, npx --yes pkg@latest, pnpm dlx pkg, yarn dlx pkg, bunx pkg and bun x pkg all run the npm package pkg.
  • uvx pkg, uv tool run pkg and pipx run pkg all run the PyPI package pkg.
  • npx mcp-remote <url> reaches the remote server at <url>.
  • No version and latest both mean the newest version.
  • ${KEY} in Claude Code, ${env:KEY} in Cursor and $KEY in Gemini CLI refer to the same environment variable.

Environment variables and headers are compared by name only, since their values can be secrets.

Supported agents

Agent--sourceMCP config fileAgent directoryFormat
Claude Codeclaude-code.mcp.json.claude/JSON, mcpServers
Codexcodex.codex/config.toml.codex/TOML, [mcp_servers.<name>]
Cursorcursor.cursor/mcp.json.cursor/JSON, mcpServers
OpenCodeopencodeopencode.json, opencode.jsonc.opencode/JSON with comments, mcp.servers or mcp
Antigravityantigravity.agents/mcp_config.jsonnoneJSON, mcpServers
Copilot CLIcopilot-cli.github/mcp.json, or .mcp.jsonnoneJSON, mcpServers or servers at the top
Factory Droiddroid.factory/mcp.json.factory/JSON, mcpServers
Gemini CLIgemini-cli.gemini/settings.jsonnoneJSON, mcpServers among other settings
Juniejunie.junie/mcp/mcp.json.junie/JSON, mcpServers
Kimi Codekimi-code.kimi-code/mcp.json.kimi-code/JSON, mcpServers
Kirokiro.kiro/settings/mcp.json.kiro/JSON, mcpServers
Qoderqoder.qoder/settings.json, .mcp.json.qoder/JSON, mcpServers among other settings
Qwen Codeqwen-code.qwen/settings.json.qwen/JSON, mcpServers among other settings
Traetrae.trae/mcp.json.trae/JSON, mcpServers

gglint compares the agents that have an MCP config file or their own directory at the repository's root. A CLAUDE.md, .cursorrules or AGENTS.md file on its own doesn't count, because it doesn't show that the agent is set up in the repository. Antigravity, Copilot CLI and Gemini CLI count only once they have their config file: many repositories have an .agents/, .github/ or .gemini/ directory for other reasons, such as skills, workflows or Gemini Code Assist's reviews.

Qoder reads Claude Code's .mcp.json as well as its own file: a server there counts as Qoder's, and a server missing from both is added to .mcp.json only.

Copilot CLI reads .mcp.json instead of .github/mcp.json whenever .mcp.json exists, so it gets the same servers as Claude Code, and gglint warns that .github/mcp.json goes unread. --fix creates a .mcp.json only if every server in .github/mcp.json is written to it. Copilot also skips a .github/mcp.json that lists no servers under mcpServers or at its top, such as one with VS Code's servers: gglint warns about it and leaves it alone.

How fixing works

Every server is copied from the first config file where it's turned on, in the order of the table in Supported agents. To make one agent the source of truth instead, name it with --source: uvx gglint mcp --fix --source codex takes each server from Codex wherever Codex has it turned on, and from the first agent otherwise. --fix never removes a server.

  • A missing server is added to each config file that lacks it.
  • An agent with its own directory but no config file gets one, with every server that is turned on in the other agents.
  • A server that runs another version of the same program, or the same program with other arguments, gets the command and arguments of that first config file. Its environment variables, headers, on/off state and keys only one agent has, such as Codex's cwd, are kept. Review the result with git diff: a difference such as a runtime chosen per agent, or a path that starts with Cursor's ${workspaceFolder}, may have been deliberate.
  • JSON is edited with jsonc-parser and TOML with toml_edit, so comments and formatting are kept.
  • Running --fix a second time changes nothing.
  • A file excluded by .gitignore is still updated, and marked gitignored in the output, because the change won't be committed.

References to environment variables are rewritten in each agent's syntax, in values and in command lines:

AgentEnvironment variable KEY
Claude Code${KEY}
Cursor${env:KEY}
OpenCode{env:KEY}
Gemini CLI, Qoder, Qwen Code$KEY or ${KEY}, written ${KEY}
Kiro, Factory Droid${KEY}, in environment variables and headers only
Codexenv_vars = ["KEY"], env_http_headers, or bearer_token_env_var for Authorization: Bearer
Kimi CodebearerTokenEnvVar for Authorization: Bearer
Antigravity, Copilot CLI, Junie, TraeNone documented, so a server that reads the environment isn't copied to them

Each server is written the way its agent expects:

  • Remote servers get "type": "http", or "sse" for a URL ending in /sse, in Claude Code, Copilot CLI, Factory Droid and Qoder.
  • Gemini CLI and Qwen Code get the URL as httpUrl, or as url for SSE.
  • Kimi Code gets "transport": "sse" for SSE, and a bearer token read from the environment as bearerTokenEnvVar.
  • Antigravity gets the URL as serverUrl. It reaches remote servers over streamable HTTP only, so a server reached over SSE isn't added.
  • Copilot CLI's local servers get "type": "local".
  • OpenCode servers get "type": "local" or "remote", with the command and its arguments in one list.

A server is skipped, and listed under Not added:, when its setup can't be expressed in the other agent's format: for example Claude Code's ${KEY:-default}, Cursor's ${workspaceFolder}, an environment variable inside a command line, which Codex, Kiro and Factory Droid don't expand, or any environment variable for an agent whose docs don't say how to refer to one.

Example

$ uvx gglint mcp --fix
Changed 4 files:
  .mcp.json             added linear
  .codex/config.toml    added github, playwright, linear
  .cursor/mcp.json      added github; updated playwright
  opencode.json (new)   added github, playwright, linear

Review the changes with `git diff`.

The same github server, written for Codex and Cursor:

# .codex/config.toml
+[mcp_servers.github]
+url = "https://api.githubcopilot.com/mcp/"
+bearer_token_env_var = "GITHUB_TOKEN"

# .cursor/mcp.json
+    "github": {
+      "url": "https://api.githubcopilot.com/mcp/",
+      "headers": {
+        "Authorization": "Bearer ${env:GITHUB_TOKEN}"
+      }
+    }

Cursor's playwright now starts as in Claude Code:

# .cursor/mcp.json
-      "args": ["-y", "@playwright/mcp@latest"]
+      "args": ["-y", "@playwright/[email protected]", "--headless"]

Output formats

--format lines prints one problem per line: where it is, the rule, and a description, with the server's other locations indented below it.

$ uvx gglint mcp --format lines
./.mcp.json:3:5  missing-server   `github` is set up for Claude Code but not for Codex (.codex/config.toml) or Cursor (.cursor/mcp.json)
./.mcp.json:8:5  different-server `playwright` runs different versions of the npm package `@playwright/mcp`: 0.0.78 in Claude Code; the newest in Cursor
    also at ./.cursor/mcp.json:3:5
./.mcp.json:3:5  missing-config   OpenCode has a .opencode directory but no opencode.json, so it gets none of the 3 MCP servers set up for Claude Code and Cursor

--servers lists every server as it's written. Environment variables and headers are shown by name, never by value.

$ uvx gglint mcp --servers
./.mcp.json:3:5  claude-code  github  https://api.githubcopilot.com/mcp/  (headers=[Authorization])
./.mcp.json:8:5  claude-code  playwright  npx -y @playwright/[email protected] --headless
./.cursor/mcp.json:3:5  cursor       playwright  npx -y @playwright/mcp@latest
./.cursor/mcp.json:7:5  cursor       linear  https://mcp.linear.app/sse

Continuous integration

Fail a pull request when the agents' MCP servers drift apart:

# .github/workflows/mcp.yml
name: MCP servers
on: [pull_request]

jobs:
  gglint:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: astral-sh/setup-uv@v7
      - run: uvx [email protected] mcp --format lines

Security

  • Read-only by default. Without --fix, gglint reads files and writes nothing.
  • Nothing is executed or fetched. MCP servers aren't started, packages aren't resolved, and environment variables aren't expanded. It's safe to run on an untrusted repository.
  • Secrets stay out of the output. Environment variables and headers are printed by name only.
  • One external program. During --fix, gglint runs git check-ignore to mark files your .gitignore excludes.

Limitations

  • Servers added by Claude Code plugins, enabled in .claude/settings.json, aren't read. A server provided by a plugin can be reported as missing from Claude Code.
  • User-level settings such as ~/.claude.json or ~/.codex/config.toml aren't read.
  • Only config files at the repository's root are read, so each package of a monorepo is checked separately.
  • VS Code and GitHub Copilot in VS Code (.vscode/mcp.json), Zed, Kilo Code, Crush, Amp, Continue and Mistral Vibe aren't supported yet (#10).
  • Gemini CLI loads only the servers listed in mcp.allowed, when its settings have that list, and never those in mcp.excluded; gglint reports the servers these lists leave out as turned off. --fix doesn't edit the lists, so a server it adds while mcp.allowed is set stays off until you add it there.
  • Windsurf, Cline and Goose read MCP servers only from the user's home directory, so there's nothing in a repository to compare.
  • Codex, Copilot CLI, Gemini CLI, Qoder and Qwen Code load a repository's MCP servers only once you trust the project or approve its servers. Trae reads .trae/mcp.json once project MCP is turned on in its settings.

Development

gglint is written in Rust. With a Rust toolchain 1.88 or later, run these three commands in order before each commit; CI runs the same checks:

cargo fmt
cargo clippy --all-targets -- --deny warnings
cargo test

tests/corpus.rs runs --fix against a directory of real repositories and checks that no server is removed, that no environment variable, header or on/off state changes, that a config file is created only in an agent's own directory, that no file becomes unreadable, that the number of missing servers and differences never grows, and that a second run changes nothing:

GGLINT_CORPUS=path/to/clones cargo test --release --test corpus -- --ignored --nocapture

The code lives in src/harness/: agents.rs describes each agent in one table, mcp.rs reads each agent's config, compare.rs finds the problems, and fix.rs writes the fixes. Supporting another agent starts with a row in agents.rs.

Releasing

  1. Update version in Cargo.toml and add the release to CHANGELOG.md.
  2. Merge to main.
  3. Publish a GitHub release tagged v<version>, for example v0.3.0.

The release workflow builds and tests every wheel, publishes them to PyPI, and attaches them to the release.

License

gglint is licensed under the Apache License 2.0. The licenses of the libraries compiled into it are listed in THIRD_PARTY_LICENSES.

// faq

What is gglint?

Keeps the MCP servers of Claude Code, Codex, Cursor, Gemini CLI and other coding agents in sync. It is open-source on GitHub.

Is gglint free to use?

gglint is open-source under the Apache-2.0 license, so it is free to use.

What category does gglint belong to?

gglint is listed under mcp-servers in the Claudeers registry of Claude-compatible tools.

1 views
★ 14 stars
unclaimed
updated 3 days ago

// embed badge

gglint on Claudeers
[![Claudeers](https://claudeers.com/api/badge/gglint.svg)](https://claudeers.com/gglint)

// retro hit counter

gglint hit counter
[![Hits](https://claudeers.com/api/counter/gglint.svg)](https://claudeers.com/gglint)

// reviews

// guestbook

0/500

// related in MCP Servers

🔓

f.k.a. Awesome ChatGPT Prompts. Share, discover, and collect prompts from the community. Free and open source — self-host for your organization with complete…

// mcp-serversf/⟨HTML⟩★ 177,810◷ NOASSERTION[ claude ]
🔓

A cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Gemini CLI & Hermes Agent. Only official website: ccswitch.io

// mcp-serversfarion1231/⟨Rust⟩★ 155,814◷ MIT[ claude ]
🔓

🪨 why use many token when few token do trick — Claude Code skill that cuts 65% of tokens by talking like caveman

// mcp-serversJuliusBrussee/⟨JavaScript⟩★ 117,780◷ MIT[ claude ]
🔓

An open-source AI agent that brings the power of Gemini directly into your terminal.

// mcp-serversgoogle-gemini/⟨TypeScript⟩★ 108,744◷ Apache-2.0[ claude ]
→ see how gglint connects across the ecosystem