Gemini CLI Integration
Schedule social media posts from Google Gemini CLI
Google's Gemini CLI supports MCP servers. Add PostQuickAI to its settings once, then ask Gemini to schedule posts, write content or pull analytics without writing any code.
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. Restrict tools (optional)
Block tools that delete things:
{
"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
Included in every plan
Every plan includes the REST API, MCP server, Claude Skills, and AGENTS.md integration, at no extra charge.
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 reads the value from your shell environment when it starts, so the key never sits in the config file.
Yes. Gemini CLI loads MCP servers at startup, so restart it after each change.
Yes. Gemini CLI supports excludeTools and includeTools arrays per server. For example, "excludeTools": ["deleteContentGroup"] blocks that delete action and leaves the other tools available.
Gemini CLI doesn't read AGENTS.md on its own, but you can point to it from your system prompt or custom commands config. The MCP tools work the same either way.
Troubleshooting
Connection failed
Set command to npx and provide args as an array. Restart the agent after changing its configuration.
Plan required
MCP and REST API access need an active plan. Every plan includes them. View plans.
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.
