{"_id":"@2lab.ai/gemini-mcp-server","_rev":"6-d6d787e882f841641f7bd6aaabb5a6e0","name":"@2lab.ai/gemini-mcp-server","dist-tags":{"latest":"1.0.7"},"versions":{"1.0.0":{"name":"@2lab.ai/gemini-mcp-server","version":"1.0.0","keywords":["mcp","gemini","server","cli"],"author":"","license":"ISC","_id":"@2lab.ai/gemini-mcp-server@1.0.0","maintainers":[{"name":"z-2lab","email":"z@2lab.ai"}],"bin":{"gemini-mcp-server":"dist/gemini-mcp-server.js"},"dist":{"shasum":"3fd001aecc84db3d53985f82e1f54a08b764ddbc","tarball":"https://registry.npmjs.org/@2lab.ai/gemini-mcp-server/-/gemini-mcp-server-1.0.0.tgz","fileCount":3,"integrity":"sha512-u8Pxv+XjubVbUHTo0T5hM98goDZFQrczddzahtoD0z2CJGwbYoxnrTbrgldJGiP33tqlkcpbSBDUg7B4Bh42kg==","signatures":[{"sig":"MEUCIQDF/imV4pvc16ZRZU1JSKwr22kmyu9Fq+oUG/dHbqaLngIgHSgzaqDvWqsKzGnFpq5UfhQKCbDYk1jVrqay0nH7lVY=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":9991},"main":"./dist/gemini-mcp-server.js","type":"module","gitHead":"25c7b11e429edb6a563a08c850efebc69259bfed","scripts":{"test":"echo \"Error: no test specified\" && exit 1","build":"tsc","start":"node dist/gemini-mcp-server.js","prepublishOnly":"npm run build"},"_npmUser":{"name":"z-2lab","email":"z@2lab.ai"},"_npmVersion":"11.6.2","description":"MCP server for interacting with Google's Gemini CLI","directories":{},"_nodeVersion":"25.2.1","dependencies":{"zod":"^4.1.13","@modelcontextprotocol/sdk":"^1.24.3"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"ts-node":"^10.9.2","typescript":"^5.9.3","@types/node":"^24.10.2"},"_npmOperationalInternal":{"tmp":"tmp/gemini-mcp-server_1.0.0_1765346722339_0.2028029790538186","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@2lab.ai/gemini-mcp-server","version":"1.0.1","keywords":["mcp","gemini","server","cli"],"author":"","license":"ISC","_id":"@2lab.ai/gemini-mcp-server@1.0.1","maintainers":[{"name":"z-2lab","email":"z@2lab.ai"}],"bin":{"gemini-mcp-server":"dist/gemini-mcp-server.js"},"dist":{"shasum":"1724b72cb0f81cafd63b938eded4e0c46e10d66d","tarball":"https://registry.npmjs.org/@2lab.ai/gemini-mcp-server/-/gemini-mcp-server-1.0.1.tgz","fileCount":3,"integrity":"sha512-xQlUHqFo3JR0xth4F5uNoN6t6nXEcjKXj4FdRFB4YcuUZBrNrWMbb2nCGa4P9iYwjfF9sW0g70/WT+NiHxwIHA==","signatures":[{"sig":"MEYCIQCzIAYijMf/Jkp3+EXSjZEqeBkg3G1+3nAsfT69uwFjJAIhALBRi6S8PKMd8kquCgibdVzcu53wtv5pXfS2v+lPIkWu","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":9991},"main":"./dist/gemini-mcp-server.js","type":"module","gitHead":"25c7b11e429edb6a563a08c850efebc69259bfed","scripts":{"test":"echo \"Error: no test specified\" && exit 1","build":"tsc","start":"node dist/gemini-mcp-server.js","prepublishOnly":"npm run build"},"_npmUser":{"name":"z-2lab","email":"z@2lab.ai"},"_npmVersion":"11.6.2","description":"MCP server for interacting with Google's Gemini CLI","directories":{},"_nodeVersion":"25.2.1","dependencies":{"zod":"^4.1.13","@modelcontextprotocol/sdk":"^1.24.3"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"ts-node":"^10.9.2","typescript":"^5.9.3","@types/node":"^24.10.2"},"_npmOperationalInternal":{"tmp":"tmp/gemini-mcp-server_1.0.1_1765347017604_0.7656207576371645","host":"s3://npm-registry-packages-npm-production"}},"1.0.2":{"name":"@2lab.ai/gemini-mcp-server","version":"1.0.2","keywords":["mcp","gemini","server","cli"],"author":"","license":"ISC","_id":"@2lab.ai/gemini-mcp-server@1.0.2","maintainers":[{"name":"z-2lab","email":"z@2lab.ai"}],"bin":{"gemini-mcp-server":"dist/gemini-mcp-server.js"},"dist":{"shasum":"a0d44caf06edb3063f331e9d54ab71c3524122c4","tarball":"https://registry.npmjs.org/@2lab.ai/gemini-mcp-server/-/gemini-mcp-server-1.0.2.tgz","fileCount":3,"integrity":"sha512-FGXlVJFuzNceqWQUvsSvKO1pZFCLLideHK8zvJCr3xJb4vFPsgmsrprvoHtxY6Oj7tDlCohxKE/G9+nArqesfQ==","signatures":[{"sig":"MEUCIQCpbcLxEukicxanHLrujh4D3zYxOiP08hZXy3S+216PdwIgPCG4m0x8OxkxXQzIHHmHcexwDKqzJ1yVi4Tq0q9tuFc=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":9990},"main":"./dist/gemini-mcp-server.js","type":"module","gitHead":"25c7b11e429edb6a563a08c850efebc69259bfed","scripts":{"test":"echo \"Error: no test specified\" && exit 1","build":"tsc","start":"node dist/gemini-mcp-server.js","prepublishOnly":"npm run build"},"_npmUser":{"name":"z-2lab","email":"z@2lab.ai"},"_npmVersion":"11.6.2","description":"MCP server for interacting with Google's Gemini CLI","directories":{},"_nodeVersion":"25.2.1","dependencies":{"zod":"^4.1.13","@modelcontextprotocol/sdk":"^1.24.3"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"ts-node":"^10.9.2","typescript":"^5.9.3","@types/node":"^24.10.2"},"_npmOperationalInternal":{"tmp":"tmp/gemini-mcp-server_1.0.2_1765347065410_0.9357765841593697","host":"s3://npm-registry-packages-npm-production"}},"1.0.5":{"name":"@2lab.ai/gemini-mcp-server","version":"1.0.5","keywords":["mcp","gemini","server","cli"],"author":"","license":"ISC","_id":"@2lab.ai/gemini-mcp-server@1.0.5","maintainers":[{"name":"z-2lab","email":"z@2lab.ai"}],"homepage":"https://github.com/2lab-ai/gemini-mcp-server#readme","bugs":{"url":"https://github.com/2lab-ai/gemini-mcp-server/issues"},"bin":{"gemini-mcp-server":"dist/gemini-mcp-server.js"},"dist":{"shasum":"7f59bf26e66d5ecf7bb0d4421530e94e31a2dd2d","tarball":"https://registry.npmjs.org/@2lab.ai/gemini-mcp-server/-/gemini-mcp-server-1.0.5.tgz","fileCount":6,"integrity":"sha512-8R7L7JUB3hADlliKdppCM+hCIBf8ZHxQ3NXMMfEBEv2M41TipHkCS1x9iGb8UAu1OYXcBm2+xxmIAirKdOK2RA==","signatures":[{"sig":"MEUCIQCVIUpHlF1AYUs08HYBT4o2oL40zIiTsgesUpBXiWqPIgIgEtV7BqQKssDJAcUWO+2kluYtkteu7vBXxsqvd6jzkN8=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@2lab.ai%2fgemini-mcp-server@1.0.5","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":21509},"main":"./dist/gemini-mcp-server.js","type":"module","gitHead":"108def62f0158370c64844dc60f07171f391b596","scripts":{"test":"vitest run","build":"tsc","start":"node dist/gemini-mcp-server.js","inspect":"npm run build; npx @modelcontextprotocol/inspector node dist/gemini-mcp-server.js","test:watch":"vitest","prepublishOnly":"npm run build"},"_npmUser":{"name":"z-2lab","email":"z@2lab.ai"},"repository":{"url":"git+https://github.com/2lab-ai/gemini-mcp-server.git","type":"git"},"_npmVersion":"10.8.2","description":"MCP server for interacting with Google's Gemini CLI","directories":{},"_nodeVersion":"20.19.6","dependencies":{"zod":"^4.1.13","@modelcontextprotocol/sdk":"^1.24.3"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^4.0.16","ts-node":"^10.9.2","typescript":"^5.9.3","@types/node":"^24.10.2"},"_npmOperationalInternal":{"tmp":"tmp/gemini-mcp-server_1.0.5_1766472659943_0.03648230985737855","host":"s3://npm-registry-packages-npm-production"}},"1.0.6":{"name":"@2lab.ai/gemini-mcp-server","version":"1.0.6","keywords":["mcp","gemini","server","cli"],"author":"","license":"ISC","_id":"@2lab.ai/gemini-mcp-server@1.0.6","maintainers":[{"name":"z-2lab","email":"z@2lab.ai"}],"homepage":"https://github.com/2lab-ai/gemini-mcp-server#readme","bugs":{"url":"https://github.com/2lab-ai/gemini-mcp-server/issues"},"bin":{"gemini-mcp-server":"dist/gemini-mcp-server.js"},"dist":{"shasum":"b43fd225164c0559ac6354b2f229e0c29de746f9","tarball":"https://registry.npmjs.org/@2lab.ai/gemini-mcp-server/-/gemini-mcp-server-1.0.6.tgz","fileCount":6,"integrity":"sha512-TO8aOioGLoQkPgtGEK2YkKV31HYZ2a8dPLzrpVltlfZfn6/KBuYROdoVkQLfMJhdpN8qDKUwjKnFFxMxreCyTg==","signatures":[{"sig":"MEUCIQDfaWEukg+FCy6A7MMv1c/2eCbxO998GnRIIynr5yluLAIgPwgxnLyB/nn49Z8/Pxm3Qiuw47bNJXOlW1etb2Yb7HA=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@2lab.ai%2fgemini-mcp-server@1.0.6","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":21869},"main":"./dist/gemini-mcp-server.js","type":"module","gitHead":"5413700fb5ba580b576331ce042c079573a53c85","scripts":{"test":"vitest run","build":"tsc","start":"node dist/gemini-mcp-server.js","inspect":"npm run build; npx @modelcontextprotocol/inspector node dist/gemini-mcp-server.js","test:watch":"vitest","prepublishOnly":"npm run build"},"_npmUser":{"name":"z-2lab","email":"z@2lab.ai"},"repository":{"url":"git+https://github.com/2lab-ai/gemini-mcp-server.git","type":"git"},"_npmVersion":"10.8.2","description":"MCP server for interacting with Google's Gemini CLI","directories":{},"_nodeVersion":"20.19.6","dependencies":{"zod":"^4.1.13","@modelcontextprotocol/sdk":"^1.24.3"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^4.0.16","ts-node":"^10.9.2","typescript":"^5.9.3","@types/node":"^24.10.2"},"_npmOperationalInternal":{"tmp":"tmp/gemini-mcp-server_1.0.6_1766473197138_0.9225426207286416","host":"s3://npm-registry-packages-npm-production"}},"1.0.7":{"name":"@2lab.ai/gemini-mcp-server","version":"1.0.7","description":"MCP server for interacting with Google's Gemini CLI","main":"./dist/gemini-mcp-server.js","bin":{"gemini-mcp-server":"dist/gemini-mcp-server.js"},"scripts":{"build":"tsc","prepublishOnly":"npm run build","start":"node dist/gemini-mcp-server.js","inspect":"npm run build; npx @modelcontextprotocol/inspector node dist/gemini-mcp-server.js","test":"vitest run","test:watch":"vitest"},"keywords":["mcp","gemini","server","cli"],"author":"","license":"ISC","repository":{"type":"git","url":"git+https://github.com/2lab-ai/gemini-mcp-server.git"},"type":"module","dependencies":{"@modelcontextprotocol/sdk":"^1.24.3","zod":"^4.1.13"},"devDependencies":{"@types/node":"^24.10.2","ts-node":"^10.9.2","typescript":"^5.9.3","vitest":"^4.0.16"},"publishConfig":{"access":"public"},"_id":"@2lab.ai/gemini-mcp-server@1.0.7","gitHead":"c00c270dfca2210f6da576186b7ca35d6904fdb0","bugs":{"url":"https://github.com/2lab-ai/gemini-mcp-server/issues"},"homepage":"https://github.com/2lab-ai/gemini-mcp-server#readme","_nodeVersion":"20.19.6","_npmVersion":"10.8.2","dist":{"integrity":"sha512-cZWNK3kkI3Srw/YHZUJ0NLiUP1N7EbWEr2zg5LuTjCsOgjYsRv+WzBpdD10dHTWyP77376RHSuTw2zYFgV049A==","shasum":"175578b734565fc930f5c2a2994426eed82f4a66","tarball":"https://registry.npmjs.org/@2lab.ai/gemini-mcp-server/-/gemini-mcp-server-1.0.7.tgz","fileCount":6,"unpackedSize":21869,"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@2lab.ai%2fgemini-mcp-server@1.0.7","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIHedgKm3AZ9TVU9/HWhIeUaVizvVKC+Wb+SGSAJlUkwFAiEA01IsxDOYXKv1rhTI+asvCuhcdw8plXfUj003Gytz2Go="}]},"_npmUser":{"name":"z-2lab","email":"z@2lab.ai"},"directories":{},"maintainers":[{"name":"z-2lab","email":"z@2lab.ai"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/gemini-mcp-server_1.0.7_1766473208232_0.5269938521618658"},"_hasShrinkwrap":false}},"time":{"created":"2025-12-10T06:05:22.271Z","modified":"2025-12-23T07:00:08.716Z","1.0.0":"2025-12-10T06:05:22.477Z","1.0.1":"2025-12-10T06:10:17.750Z","1.0.2":"2025-12-10T06:11:05.542Z","1.0.5":"2025-12-23T06:51:00.081Z","1.0.6":"2025-12-23T06:59:57.278Z","1.0.7":"2025-12-23T07:00:08.368Z"},"bugs":{"url":"https://github.com/2lab-ai/gemini-mcp-server/issues"},"license":"ISC","homepage":"https://github.com/2lab-ai/gemini-mcp-server#readme","keywords":["mcp","gemini","server","cli"],"repository":{"type":"git","url":"git+https://github.com/2lab-ai/gemini-mcp-server.git"},"description":"MCP server for interacting with Google's Gemini CLI","maintainers":[{"name":"z-2lab","email":"z@2lab.ai"}],"readme":"# Gemini MCP Server\n\nA Model Context Protocol (MCP) server that provides a bridge to Google's Gemini CLI. This allows MCP-compliant clients (like Claude Desktop) to interact with the Gemini CLI to start new chat sessions or continue existing ones directly from the client interface.\n\n## Features\n\n- **Start New Sessions**: Initiate a new conversation with a specific Gemini model.\n- **Continue Sessions**: Reply to existing sessions using their Session ID.\n- **Session Management**: Automatically detects the latest session ID if one is not provided for replies.\n- **Model Selection**: Supports specifying different Gemini models (e.g., `gemini-3-pro`).\n\n## Prerequisites\n\nBefore using this server, ensure you have the following installed:\n\n1.  **Node.js**: v18 or higher.\n2.  **Gemini CLI**: You must have the `gemini` CLI tool installed and configured on your system.\n    - Ensure `gemini` is in your system's PATH.\n    - Ensure you have authenticated or set up necessary API keys for the `gemini` CLI to work.\n\n## Installation\n\nYou can run this server directly using `npx` or by building it locally.\n\n### Local Setup\n\n1.  Clone the repository:\n    ```bash\n    git clone <repository-url>\n    cd gemini-mcp-server\n    ```\n\n2.  Install dependencies:\n    ```bash\n    npm install\n    ```\n\n3.  Build the project:\n    ```bash\n    npm run build\n    ```\n\n## Configuration\n\nTo use this with an MCP client (e.g., Claude Desktop), add the server configuration to your client's settings file.\n\n### Claude Desktop Configuration\n\nAdd the following to your `claude_desktop_config.json` (usually located at `~/Library/Application Support/Claude/claude_desktop_config.json` on macOS or `%APPDATA%\\Claude\\claude_desktop_config.json` on Windows):\n\n**Using source (for development):**\nMCP (Model Context Protocol) server for interacting with Google's Gemini CLI.\n\nThis server allows AI assistants like Claude to use Google's Gemini through the MCP protocol.\n\n## Prerequisites\n\n- Node.js 18+\n- [Gemini CLI](https://github.com/google-gemini/gemini-cli) installed and authenticated\n\n```bash\n# Install Gemini CLI\nnpm install -g @anthropic-ai/gemini-cli\n# or\nbrew install gemini-cli\n\n# Authenticate\ngemini auth\n```\n\n## Installation\n\n### Global Installation\n\n```bash\nnpm install -g @2lab.ai/gemini-mcp-server\n```\n\n### Run directly with npx\n\n```bash\nnpx @2lab.ai/gemini-mcp-server\n```\n\n## Usage\n\n### Running the server\n\nAfter global installation:\n\n```bash\ngemini-mcp-server\n```\n\nOr with npx:\n\n```bash\nnpx @2lab.ai/gemini-mcp-server\n```\n\n### Testing with MCP Inspector\n\nYou can test and debug the server using the MCP Inspector:\n\n```bash\nnpx @modelcontextprotocol/inspector npx @2lab.ai/gemini-mcp-server\n```\n\nOr if globally installed:\n\n```bash\nnpx @modelcontextprotocol/inspector gemini-mcp-server\n```\n\n### Claude Desktop Configuration\n\nAdd the following to your Claude Desktop configuration file:\n\n**macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`\n**Windows**: `%APPDATA%\\Claude\\claude_desktop_config.json`\n\n```json\n{\n  \"mcpServers\": {\n    \"gemini\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@2lab.ai/gemini-mcp-server\"]\n    }\n  }\n}\n```\n\nOr if globally installed:\n\n```json\n{\n  \"mcpServers\": {\n    \"gemini\": {\n      \"command\": \"gemini-mcp-server\"\n    }\n  }\n}\n```\n\n### Claude Code Configuration\n\nAdd to your Claude Code settings:\n\n```json\n{\n  \"mcpServers\": {\n    \"gemini\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@2lab.ai/gemini-mcp-server\"]\n    }\n  }\n}\n```\n\n## Available Tools\n\n### `gemini`\n\nStart a new Gemini session with a prompt.\n\n**Parameters:**\n- `prompt` (required): The prompt to start the session with\n- `model` Optional: The model to use (e.g., 'gemini-3-pro', 'gemini-3-flash').\n\n\n**Returns:** Response text and new Session ID\n\n### `gemini-reply`\n\nContinue an existing Gemini session.\n\n**Parameters:**\n- `prompt` (required): The prompt to continue the conversation\n- `sessionId` (optional): The session ID to continue. If not provided, uses the latest session\n- `model` (optional): The model to use for this turn\n\n**Returns:** Response text\n\n## Development\n\n```bash\n# Clone the repository\ngit clone https://github.com/2lab-ai/gemini-mcp-server.git\ncd gemini-mcp-server\n\n# Install dependencies\nnpm install\n\n# Build\nnpm run build\n\n# Run locally\nnpm start\n```\n\n## CI/CD\n\nThis project uses GitHub Actions to automatically publish to npm when changes are pushed to the `main` branch.\n\nTo enable automatic publishing:\n\n1. Generate an npm access token from [npmjs.com](https://www.npmjs.com/settings/~/tokens)\n2. Add the token as a secret named `NPM_TOKEN` in your GitHub repository settings\n3. Bump the version in `package.json` before pushing to trigger a publish\n\n## License\n\nISC\n","readmeFilename":"README.md"}