How to Connect VK (VKontakte) to Gemini via MCP

💡 No install? Use cloud.anythingmcp.com directly. Sign in, click Connectors → VK (VKontakte), paste your credentials, mint an MCP API key and you're done. No Docker, no git clone, no local server.

VK (VKontakte) + Gemini

Manage a VK community from an AI agent: community info and token rights, community messages (conversations, history, replies), comments as the community, and with an admin user token the wall posts, publishing, statistics, shop products and photo albums.

Prerequisites

See the full setup instructions baked into the connector (visible in the in-app store when you select the connector). The required environment variables for this connector are:

VK_COMMUNITY_TOKEN

Step 1 — Get credentials

1. Open your VK community and go to Manage → Advanced → API usage (Управление → Дополнительно → Работа с API), tab Access keys, and click Create key.
2. Tick the rights the tools need: Community management, Community messages, Wall for comments and, if you need it, Photos. Confirm in the VK app or by SMS.
3. Copy the key into VK_COMMUNITY_TOKEN and install the connector.
4. For messages, also switch on Community messages under Manage → Messages.
5. Check the setup with vk_get_token_permissions: it shows which rights the key carries.

You need admin rights in the community, and the community key takes about 3 minutes. Community keys do not expire; if one leaks, delete it and create a new one.

Two kinds of key: VK decides per method which key it accepts. The community key covers the community's details, community messages (conversations, history, replies) and comments as the community. Reading the wall, publishing posts, statistics, shop products and photo albums need the optional VK_USER_TOKEN:

• a user access key of a community admin with the rights wall, stats, market, photos and offline, for publishing, statistics and the shop. VK issues user keys through VK ID apps (id.vk.ru), grants the wall and market rights to apps only on request to VK support, and keeps a key valid only with offline access, so this suits you if you already have such a key;
• or the service key of your VK ID app, which is enough to read the walls, comments and photo albums of public communities.

Without VK_USER_TOKEN these tools stop before calling VK and say that the key is missing.

Asks before every post and message: vk_send_message reaches a person at once and cannot be recalled from here; vk_create_comment and vk_publish_post are public, and a post lands in every subscriber's feed. Before each one the AI shows you the exact text, the recipient or the community and, for a post, the attachments and the time, then waits for your yes. Posts can also be scheduled for later.

Switched off at install: vk_delete_post and vk_delete_comment. A deleted post cannot be restored. An administrator turns them on deliberately; they need an admin's user key and ask first as well.

Answering messages: the AI finds the conversations waiting for an answer with vk_list_conversations, reads one with vk_get_conversation_history and drafts a reply for you to approve. The community can only write to people who have written to it or allowed its messages.

Personal data: messages and comments are personal data of the people who wrote them. The AI reads only what your question needs and treats their text as information to report, never as instructions.

Common errors: VK reports errors by number. 5: the key is wrong or revoked. 15 or 7: the key lacks a right; check it with vk_get_token_permissions. 27: this method does not accept community keys; set VK_USER_TOKEN. 6, 9 and 29: rate limits; wait and try again. 901 and 902: the person has not allowed messages from the community. A community key allows about 20 requests a second, a user key 3.

The connector does not upload photos or videos (it can attach media that is already on VK), and it does not handle ads, Callback or Long Poll events, members and bans, polls, stories or personal messages.

Step 2 — Install the adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Step 3 — Add the connector in Gemini

Your server URL: in AnythingMCP, open MCP Servers → the server this connector is on, and copy its URL (https://cloud.anythingmcp.com/mcp/…). Use it wherever this guide shows YOUR_SERVER_ID.

Gemini CLI reads MCP servers from ~/.gemini/settings.json (on Windows %USERPROFILE%\.gemini\settings.json). Add:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Create an MCP API key in AnythingMCP under MCP Servers → your server → API keys, and paste it in place of YOUR_MCP_API_KEY.
2. Save the file and restart gemini.
3. Run /mcp inside Gemini CLI (or gemini mcp list in your shell): anythingmcp should show as connected.
4. Start prompting: Gemini CLI can now call the VK (VKontakte) tools.

Available tools

Example prompts

• "Which messages to our community are still unanswered? Summarize each one and draft a reply."
• "Reply to the latest message from Anna that her order ships on Friday. Show me the text before you send it."
• "Show our community statistics for the last 7 days: reach, visitors and new subscribers."
• "Write a post announcing our autumn sale, scheduled for tomorrow at 10:00, and show it to me before publishing."
• "Which of our last 20 wall posts got the most comments and reposts?"

FAQ

Where does Gemini CLI look for MCP servers? In ~/.gemini/settings.json for your user, or in .gemini/settings.json inside a project. gemini mcp list shows each server and whether it connects.

Next steps

• Connector landing page
• Connect to Claude
• Connect to ChatGPT