Windows Gemini Workspaces MCP
Provides read-only Git queries inside configured workspaces, allowing inspection of repository status, commit log, and unstaged diffs.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
Windows Gemini Workspaces MCP
A security-hardened Model Context Protocol (MCP) server that gives Gemini App live, controlled read/search/edit/command access to selected local Windows workspaces over GitHub OAuth 2.0 + Tailscale Funnel.
Highlights
Single-Owner GitHub OAuth + DCR Guard: Authenticates via GitHub OAuth with strict
MCP_GITHUB_OWNER_IDverification, Fernet-encrypted persistent token/client storage, configurable Dynamic Client Registration lockdown (MCP_ALLOW_DCR=0), and client-count caps (MCP_MAX_REGISTERED_CLIENTS).Windows Path & Symlink/Junction Sandboxing: Uses Win32
CreateFileWhandle locks and reparse-point checks to block directory traversal, NTFS junctions, symlinks, hardlink aliases, protected files (.env,.git, private keys), and edits to the running MCP server directory itself.Fast Search & Code Navigation: Native
ripgrep(rg.exe) content search with automatic ignore rules, Everything CLI (es.exe) filename lookup with automaticrg --filesfallback,ast-grepstructural search, and read-only Git queries.CRLF-Safe Atomic Edits & Automatic Backups: Optimistic version-hash locking (
read_workspace_ranges->edit_workspace_file/write_workspace_file), automatic CRLF/LF detection and preservation, and rolling backup retention (latest 200 snapshots).Controlled PowerShell Execution: ANSI-stripped UTF-8 output with head+tail truncation, sensitive environment variable redaction (
*TOKEN*,*SECRET*,*API_KEY*,*PASSWORD*), background job polling, and Win32 Job Object process-tree cleanup to prevent orphan child processes.
Related MCP server: ArgonDesk
Available Tools (13)
Tool | Mode | Description |
| Read-only | Connectivity and OAuth health check |
| Read-only | List configured workspace names and local roots |
| Read-only | Browse directory tree up to configurable depth/limit |
| Read-only | Fast filename search via Everything CLI (falls back to |
| Read-only | Case-insensitive literal text search powered by |
| Read-only | Structural code search powered by |
| Read-only | Read up to 8 line ranges with version hashes for optimistic edits |
| Read-only | Inspect |
| Write | Apply 1–12 unique replacements with CRLF preservation and auto-backup |
| Write | Create or overwrite a UTF-8 file with version guard and auto-backup |
| Exec | Run PowerShell commands synchronously or as background jobs |
| Read-only | Poll stdout/stderr and exit status of a command job |
| Exec | Terminate a running background command job and its child process tree |
Quick Start
1. Prerequisites
Windows 10/11 with Python 3.11+ and PowerShell 7 (
pwsh)Tailscale with Funnel enabled (or another HTTPS reverse proxy)
Optional CLI tools on
PATH(or configured via.env):rg.exe(ripgrep),es.exe(Everything CLI),ast-grep.exe,git.exe
2. Install Dependencies
python -m venv .venv
.\.venv\Scripts\pip.exe install -e .
.\.venv\Scripts\pip.exe install pytest httpx3. Configure Environment & GitHub OAuth Secret
Copy
.env.exampleand configure your environment variables (MCP_PUBLIC_BASE,MCP_GITHUB_CLIENT_ID,MCP_GITHUB_OWNER_ID,MCP_WORKSPACES).Create a GitHub OAuth App with callback URL
https://<your-node>.ts.net/auth/callback.Store your GitHub OAuth client secret encrypted with Windows DPAPI (CurrentUser scope):
$dir = Join-Path $env:LOCALAPPDATA 'WindowsGeminiMCP'
New-Item -ItemType Directory -Force -Path $dir | Out-Null
$secret = Read-Host -Prompt 'GitHub OAuth Client Secret' -AsSecureString
ConvertFrom-SecureString $secret | Set-Content (Join-Path $dir 'github-client-secret.dpapi') -Encoding UTF8Initialize the persistent state directory once:
$stateDir = Join-Path $env:LOCALAPPDATA 'WindowsGeminiMCP\live-state'
New-Item -ItemType Directory -Force -Path $stateDir | Out-Null
.\.venv\Scripts\python.exe synthetic_edits.py init --workspaces4. Expose via Tailscale Funnel & Start
tailscale funnel --bg --set-path=/mcp 8766
$env:MCP_ALLOW_DCR = '1' # Enable during first-time Gemini App linking
.\start_live_task.ps1Once linked in Gemini App, set MCP_ALLOW_DCR=0 (the default in start_live_task.ps1) to lock down public /register requests.
5. Run Tests
.\.venv\Scripts\pytest.exe -vSecurity Notes
Keep
%LOCALAPPDATA%\WindowsGeminiMCPrestricted to your Windows user,SYSTEM, andAdministrators(icacls).Never commit
.env,workspaces.json, or*.dpapifiles.edit_workspace_fileandwrite_workspace_fileintentionally block writes into the running MCP server directory.
License
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Access the GitHub API, enabling file operations, repository management, search functionality, and…
Connect ChatGPT, Claude, Cursor or VS Code to your Windows PC: files, terminal, browser, apps.
Operate GitHub from your AI assistant: repos, PRs, issues, Actions. Previews and read-only mode.
Connect AI assistants to your GitHub-hosted Obsidian vault to seamlessly access, search, and analy…
Related MCP Servers
- AlicenseNot gradedqualityBmaintenanceEnables Gemini Spark to securely read, edit, and search a selected local workspace, execute shell commands, and integrate development tools via MCP with user approval safeguards.1MIT
- AlicenseNot gradedqualityBmaintenanceEnables the Gemini website, connected through Google's native custom MCP app, to list, read, create, edit and organize UTF-8 text files inside a user-chosen local folder on Windows. Access is bounded by a selected root, a workspace ID, a pause switch and read-only or read-and-edit permission, reached over a private HTTPS tunnel without needing a model API key.3MIT
- AlicenseNot gradedqualityCmaintenanceEnables Google Gemini to autonomously read, write, search, and patch code files and run whitelisted developer commands inside a sandboxed local workspace for edit-and-verify coding workflows.1MIT
- AlicenseNot gradedqualityCmaintenanceEnables an authorized ChatGPT client to perform Windows-local file operations, coding, Git inspection, desktop interaction, and autonomous tasks with OAuth owner authorization and audit.3MIT