
appstoreconnect
io.github.homielab/appstoreconnect
App Store Connect: TestFlight, versions, review submission, reviews, sales reports
Documentation
mcp-homielab
Model Context Protocol servers for people who build and ship apps, browser extensions and websites. Let Claude, Cursor or any MCP client read your AdSense, AdMob and Search Console reports, publish to Google Play, App Store Connect, Chrome Web Store and Firefox Add-ons, manage a Blogger blog, and generate images, speech, music and video with Gemini.
One static binary, no runtime. Each service runs as its own stdio MCP server
(mcp-homielab <service>), so you add only the ones you use.
Unofficial: not affiliated with or endorsed by Google, Apple or Mozilla. You use your own API credentials; nothing is sent anywhere except the API each service wraps.
Install
macOS / Linux:
curl -fsSL https://raw.githubusercontent.com/homielab/homielab-mcp/main/install.sh | sh
Installs to ~/.local/bin (set MCP_HOMIELAB_INSTALL_DIR to change). Windows: download the zip
from Releases. With Go 1.27+:
go install github.com/homielab/homielab-mcp/cmd/mcp-homielab@latest.
Quick start
mcp-homielab add searchconsole # register with Claude Code (or: add all)
mcp-homielab searchconsole login # Google services: sign in once (setup below)
Other clients: mcp-homielab add --client claude-desktop <service>, --client cursor, or
--client json to print the config:
{
"mcpServers": {
"searchconsole": { "command": "/path/to/mcp-homielab", "args": ["searchconsole"] }
}
}
Run mcp-homielab to list services, mcp-homielab <service> --help for one service's commands
and credential lookup.
Services
| Service | API | Auth |
|---|---|---|
adsense | AdSense Management API v2 (read-only): reports by site, page, ad unit, country…, 18 presets, CSV export, policy issues | |
admob | AdMob API v1 (read-only): apps, ad units, network and mediation reports, 13 presets, period comparison, CSV export | |
searchconsole | Search Console: Search Analytics, quick report, period comparison, sitemaps, URL inspection; add/remove properties and sitemaps | |
googleplay | Google Play Developer API (read-write): tracks and staged rollout, .aab/.apk upload, listings and images, IAP, reviews, purchase verification | |
appstoreconnect | App Store Connect API (read-write): TestFlight, versions and metadata, review submission, release, customer reviews, IAP, sales and finance reports | API key |
blogger | Blogger API v3 (read-write): posts and pages (create, edit, publish, schedule, delete), comment moderation, page views | |
chromewebstore | Chrome Web Store API v2 (read-write): status, upload, publish (staged, % rollout), cancel, rollback, reviews, metrics | |
firefoxaddons | addons.mozilla.org API v5 (read-write): listing, icon, screenshots, upload and validation, version submit, rollback, ratings, search | API key |
gemini | Gemini API media generation (paid per call): images, speech, music, video, spend log | API key |
Setup per service
Google services (adsense, admob, searchconsole, googleplay, blogger,
chromewebstore) share one OAuth client:
- In Google Cloud Console, enable the APIs you need and create one OAuth Client ID of type Desktop app. Download its JSON.
- Put it in the shared config dir, so it serves every Google service:
- macOS:
~/Library/Application Support/mcp-homielab/ - Linux:
~/.config/mcp-homielab/ - Windows:
%AppData%\mcp-homielab\
- macOS:
mcp-homielab <service> login(or ask the agent; it calls<prefix>_login).
App Store Connect: mcp-homielab appstoreconnect setup --key-file AuthKey_<KEYID>.p8 --issuer-id <ID>
(details).
Firefox Add-ons: mcp-homielab firefoxaddons setup --issuer <JWT issuer>
(details).
Gemini: set GEMINI_API_KEY, or mcp-homielab gemini setup
(details).
Step-by-step guide and troubleshooting: INSTALL.md.
Credentials, tokens and state live in <user config dir>/mcp-homielab/<service>/ with mode 0600.
Set MCP_HOMIELAB_CONFIG_DIR to use another dir.
Safety
Several services can write: publish releases, edit store listings, delete items. gemini
spends money on every call. Read a service's README before giving an agent access, and add only
the services you need.
Development
git clone https://github.com/homielab/homielab-mcp.git && cd homielab-mcp
./build.sh # gofmt + vet + test, then builds mcp-homielab into $(go env GOPATH)/bin
| Path | Contents |
|---|---|
cmd/mcp-homielab/main.go | Service list and entry point |
services/<id>/ | One service: main.go (Service(), instructions), API client, tools, prompts, tests |
internal/mcpkit/ | CLI (<service>, login/logout, add), *_login tools, tool result helpers |
internal/googleauth/ | OAuth loopback + PKCE, client secret lookup, token store, background login |
internal/googleapi/ | JSON client: retry on 429/5xx, Retry-After, Google error decoding, pagination |
internal/appdir/ | Config dir (MCP_HOMIELAB_CONFIG_DIR or <user config dir>/mcp-homielab) |
internal/daterange/, internal/render/ | Date presets; Markdown/CSV tables and CSV export |
Add a service:
- Create
services/<id>/main.gowithfunc Service() mcpkit.Server. A Google API declares agoogleauth.Provider(Name = id, scope, env prefix, tool prefix) and adds the id togoogleauth.Collection; an API-key service setsID,Credentialsand asetupcommand (seeservices/gemini). - API client:
googleapi.New(hc, "<API name>")withhcfromauth.HTTPClient(ctx). - Tools:
mcpkit.AddLoginTools, then the service's tools (withTitleandAnnotations), prompts and tests. - Add it to the list in
cmd/mcp-homielab/main.go.
Release: push a tag vX.Y.Z; GitHub Actions runs GoReleaser and attaches binaries for macOS,
Linux and Windows (amd64, arm64). Publishing the release lists every service in the
MCP Registry as io.github.homielab/<service>.
Contributing
Issues and pull requests are welcome. Run ./build.sh before a PR. Tests use local fake servers
and never call a real API; keep it that way, and never commit real account ids, tokens or keys.
Report a vulnerability privately through GitHub security advisories, not a public issue.
License
No installation packages available.
Related Servers
io.github.homielab/admob
Read AdMob apps, ad units, network and mediation reports, period comparison, CSV export
io.github.homielab/adsense
Read AdSense reports: earnings by site, page, ad unit and country, presets, CSV export
io.github.homielab/blogger
Blogger posts and pages: create, edit, schedule, publish; comment moderation