Gemini CLI Integration
PostQuickAI for Google Gemini CLI
Google's Gemini CLI meets the universal MCP protocol. Add PostQuickAI once, then ask Gemini to schedule posts, generate content, or pull analytics — no custom code required.
1. Add to settings.json
Edit ~/.gemini/settings.json (or .gemini/settings.json for project scope):
{
"mcpServers": {
"postquickai": {
"command": "npx",
"args": ["-y", "@postquickai/mcp"],
"env": {
"POSTQUICKAI_API_KEY": "$POSTQUICKAI_API_KEY"
}
}
}
}Then export the key in your shell (e.g. in ~/.zshrc):
export POSTQUICKAI_API_KEY=pq_live_your_key_here2. Optional — restrict tools
Block destructive operations for added safety:
{
"mcpServers": {
"postquickai": {
"command": "npx",
"args": ["-y", "@postquickai/mcp"],
"env": { "POSTQUICKAI_API_KEY": "$POSTQUICKAI_API_KEY" },
"excludeTools": ["deleteContentGroup", "deletePost", "deleteVideo", "disconnectAccount"]
}
}
}3. Restart and test
Restart Gemini CLI, then ask it:
API and agent access
Add programmatic access to Basic or Pro
The paid API and agent add-on includes the REST API, MCP server, Claude Skills, and AGENTS.md integration. It is not included with either scheduler plan.
FAQ
Frequently Asked Questions
Global: ~/.gemini/settings.json. Project-scoped: .gemini/settings.json in your repo root. MCP servers are defined under the top-level mcpServers key.
Use environment-variable expansion. In settings.json, set "POSTQUICKAI_API_KEY": "$POSTQUICKAI_API_KEY" — Gemini CLI pulls the value from your shell env at runtime instead of hard-coding it in the config file.
Yes. MCP servers load at startup. Restart the Gemini CLI process for changes to take effect.
Yes. Gemini CLI supports excludeTools and includeTools arrays per server. Example: "excludeTools": ["deleteContentGroup"] blocks destructive operations while keeping read/write tools available.
Gemini CLI doesn't natively read AGENTS.md, but you can reference it in your system prompt or custom commands config. The MCP tools still work identically.
Troubleshooting
Connection failed
Set command to npx and provide args as an array. Restart the agent after changing its configuration.
API add-on required
MCP and REST API access require the paid add-on. View add-on details.
API key missing
Create a key in API settings. Keys begin with pq_live_ and belong in the MCP configuration environment block.
Rate limit reached
Basic allows 30 requests/minute and 5,000/day. Pro allows 120 requests/minute and 50,000/day. Read the rate-limit reference.
Gemini CLI setup still failing
Check the developer documentation or email konark@arktechllc.net.
Setup guides for other agents
Each guide uses the same PostQuickAI API and MCP server with tool-specific configuration.
