You see the message “Invalid access key”

The key may have been revoked or copied wrong. Create a new key in Settings › AI access, then paste it again with no spaces at the start or end.

The assistant says it cannot find the group

The assistant can only read groups you chose in the dashboard. Add the group first, then use the group name exactly as it appears in WhatsApp.

Your quota runs out before the end of the month

Check your remaining quota with the prompt “How much Grupy quota do I have left?”. Quota resets at the start of each month. Open your account page after you sign in to see your plan and its limits.

The message reading tool is missing

read_messages and search_messages only appear after the Read messages permission is turned on for your AI connection or access key on the MCP page. Turn it on, then check the tool list again.

Your WhatsApp number is disconnected

Open the dashboard and scan the QR code again. Your AI assistant can read your groups again once the number is connected.

grupy.chatDocs

Documentation›MCP›Connect an AI assistant

MCP server

Connect Grupy to your AI assistant

Ask about your WhatsApp groups right from Claude, ChatGPT, or another AI agent. Grupy reads and summarizes, and your assistant just answers.

Updated Oct 2, 2026 · 4 min read

Quick start

± 2 min

1 Copy the server URL

mcp.grupy.chat

2 Add it to your AI assistant Open the Connectors or MCP settings, then paste the URL.

3 Log in and approve Log in to Grupy and click Approve. Hermes and other agents use an access key.

Connect an AI assistant

Pick the assistant you use. Claude and ChatGPT only need the URL. Hermes, OpenClaw, and other agents need an access key.

See all supported apps

Connect to Claude

URL only

Add Grupy as a connector with the URL, then log in to Grupy and approve. No access key needed.

Info You do not need an access key. The server URL and a login to your Grupy account are enough.

1

Open the Connectors menu

In Claude, open Settings, choose Connectors, then click Add custom connector.
2

Paste the server URL

Enter Grupy as the name, paste the URL below, then click Add.

Server URL https://mcp.grupy.chat/mcp
3

Log in to Grupy

Claude opens the Grupy page. Log in with the same Google account you use for your dashboard.
4

Approve access Check the permissions, then click Approve. Grupy shows up in Claude's tool list right away.
Tip Try asking: "Which groups did I turn on for summaries?"

Connect to ChatGPT

URL only

Add Grupy as a connector with the server URL. You only log in and approve once.

Important The connector menu can differ depending on your ChatGPT plan. If it does not show up, check your ChatGPT account settings.

1

Open the Connectors menu

In ChatGPT, open Settings, choose Connectors, then click Add connector.
2

Paste the server URL

Enter Grupy as the name, paste the URL below, then click Add.

Server URL https://mcp.grupy.chat/mcp
3

Log in and approve

Log in with your Google account, check the permissions, then click Approve. Grupy is ready to use in a new chat.

Tip Try asking: "Summarize the Class 4B Parents group since yesterday."

Connect to Hermes

URL + access key

Hermes connects with the server URL and an access key that you create in your Grupy dashboard.

Info Hermes needs two things: the server URL and an access key from your Grupy dashboard.

1

Create an access key

In your Grupy dashboard, open Settings, choose AI access, then click Create new key. Name it "Hermes" so it is easy to recognize.
2

Copy the server URL and the key

The full key is shown only once. Store it somewhere safe.

Server URL https://mcp.grupy.chat/mcp

Access key gk_live_••••••••••••••••••••gk_live_7Hq2mX9pR4tL8vNc3sWd

Important Do not share your access key. Anyone who holds this key can read your group summaries. If it leaks, revoke it in the dashboard.
3

Paste it into Hermes

Open the MCP settings in Hermes, add a new server, then enter the server URL and the access key.
4

Try your first prompt Ask anything about your groups. If it works, Hermes calls a Grupy tool.
Tip Use the group name exactly as it appears in WhatsApp so the result is accurate.

Connect to OpenClaw

URL + access key

OpenClaw connects with the server URL and an access key that you create in your Grupy dashboard.

Info OpenClaw needs two things: the server URL and an access key from your Grupy dashboard.

1

Create an access key

In your Grupy dashboard, open Settings, choose AI access, then click Create new key. Name it "OpenClaw" so it is easy to recognize.
2

Copy the server URL and the key

The full key is shown only once. Store it somewhere safe.

Server URL https://mcp.grupy.chat/mcp

Access key gk_live_••••••••••••••••••••gk_live_7Hq2mX9pR4tL8vNc3sWd

Important Do not share your access key. Anyone who holds this key can read your group summaries. If it leaks, revoke it in the dashboard.
3

Paste it into OpenClaw

In OpenClaw, open the Tools or MCP settings, add a server, then enter the server URL and the access key.
4

Try your first prompt Ask anything about your groups. If it works, OpenClaw calls a Grupy tool.
Tip Use the group name exactly as it appears in WhatsApp so the result is accurate.

Connect to Other agent

URL + access key

For any app or agent that supports MCP over HTTP.

Info Works in any app that supports MCP servers over HTTP.

1

Create an access key

In your Grupy dashboard, open Settings, choose AI access, then click Create new key. Name it "Other agent" so it is easy to recognize.
2

Copy the server URL and the key

The full key is shown only once. Store it somewhere safe.

Server URL https://mcp.grupy.chat/mcp

Access key gk_live_••••••••••••••••••••gk_live_7Hq2mX9pR4tL8vNc3sWd

Important Do not share your access key. Anyone who holds this key can read your group summaries. If it leaks, revoke it in the dashboard.
3

Paste it into your agent

Find the MCP menu in your app. Enter the server URL, then send the key as an Authorization header as shown below.

Header Authorization: Bearer gk_live_••••••••••••••••••••
4

Try your first prompt Ask anything about your groups. If it works, your agent calls a Grupy tool.
Tip Use the group name exactly as it appears in WhatsApp so the result is accurate.

Available tools

Your AI assistant calls these tools on its own. You just ask in plain language.

Summaries run in a queue. summarize_group or summarize_groups returns summaries that hold task IDs, not the final result. Send each ID as summary_id to get_summary. Read text once the status is completed; while it is pending or running, check again later. If it is failed, read error_code.

read_messages appears after the Read messages permission is turned on for an AI connection or access key on the MCP page. Chat content is sent to the AI that you connected. Use group_id, from, and to with ISO timestamps. The age limit of stored messages and the reading range follow your current plan: 7 days on Free, and more on paid plans. The default limit is 200 messages, with a maximum of 500. For the next page, send next_cursor as cursor with the same group and range. Regular messages are available from the time the group was turned on; earlier messages can be read only if they were imported with your consent for that group and range. Downgrading your plan limits access right away to match the new plan. This reading does not run the Grupy model and does not use up your summary quota. MCP rate limits still apply; the cost or limits of your AI follow that AI service.

History import is available in the dashboard for groups that are selected, active, and still connected. Choose from 1 day up to your plan limit: 7 days on Free, and more on paid plans. Check the range and give your consent before you start. Grupy asks for the text and captions that are still available in WhatsApp, including messages from before the group was turned on. Import does not run AI, OCR, transcription, or automatic summaries. WhatsApp may provide only part of the history; the number shown is new messages saved, not proof that the whole range is complete. Each run is limited to 1,000 new messages, 4 MiB of text, 20 pages, and 10 minutes. If a run is partial because of an app limit, continue with your consent for the same range; the run picks up from the saved position. If there is no message reference yet, send a regular message in the group and try again. Messages that were imported successfully still follow the storage limit of your current plan. Create a manual summary after the import; its range follows your plan and uses summary quota.

The activate_groups, deactivate_groups, update_group_schedule, sync_groups, and set_summary_language tools appear after the Manage groups permission is turned on for an AI connection or access key on the MCP page. This permission is off by default. You can turn it off at any time. These tools do not send WhatsApp messages and do not change group members or admins. One call to activate_groups or deactivate_groups handles 1 to 50 groups and returns a result for each group. list_groups accepts a status of active (default), inactive, or all. list_numbers shows the active groups, the group limit, and the free slots of each number. A group turns on only if its number is connected, is not paused by your plan, and has a free slot. When a group is turned off, new messages from that group are not saved, the summary schedule stops, and a running history import stops. Messages that are already saved stay, within your plan limit. Messages sent while a group is off can only be fetched later with a history import. sync_groups refreshes the group list of one number from WhatsApp. New groups stay off until activate_groups turns them on, and a group that the number has left turns off. set_summary_language changes the language of new summaries for the whole account. Existing and queued summaries keep their language.

Ready-made prompts: daily_briefing builds a daily briefing of your groups, weekly_review builds a weekly review, my_tasks lists the tasks that wait for you, and group_digest sums up one group (argument group). Choose a prompt from the prompt menu of an AI app that supports prompts. A prompt only writes the request. The data still comes from the tools above, and the permissions of the connection still apply.

NameWhat it doesExample promptsPlan

List groupslist_groups

Shows the ID, name, and summary schedule of the groups in your account, with a filter for active (default), inactive, or all groups. “Show the groups I turned on, along with their summary schedules.” All plans

List numberslist_numbers

Shows each WhatsApp number in the account with a masked number, its status, its active groups, the group limit of your plan, and its free group slots. “How many free group slots do I have on my WhatsApp number?” All plans

Read stored messagesread_messages

Reads stored text from your active groups after you allow message reading on the MCP page. The AI you connected can summarize it on its own. “Read the stored messages from the group I chose over the last 24 hours, then summarize them with this AI.” All plans · message reading permission

Group summarysummarize_group

Queues a summary task for one group over a given time range. “Summarize the Class 4B Parents group since yesterday, then read the result when it is done.” All plans

Cross-group summarysummarize_groups

Queues one summary task for each group you select. “Summarize the work groups I picked for this week, then read the result for each group.” Higher plans

Read summary resultget_summary

Reads the status and result of one of your summary tasks by summary_id. “Check the summary task from earlier and show me the result if it is finished.” All plans

Search summariessearch

Searches the text of the finished summaries in your account, newest first, up to 20 results. Each result has an id, a title, and a link to the summary in the dashboard. ChatGPT deep research uses it most. “Search my summaries for the monthly dues.” All plans

Get summary textfetch

Gets the full text of one summary in your account by an id from search. The result has the id, title, text, link, and metadata. An unknown id, or an id from another account, gives not found. “Open the summary from that search and explain the decisions.” All plans

Cancel summarycancel_summary

Cancels one pending or running summary of your account by summary_id. A cancelled summary does not use summary quota. A finished summary cannot be cancelled. “Cancel the Class 4B Parents summary that is still running.” All plans

Export numbersexport_members

Creates a CSV of group members after you approve the export in the dashboard. Hidden numbers are still marked. “Export the members of the Class of 2012 Alumni group to CSV.” All plans

Check quotacheck_quota

Shows your plan, your usage, and your remaining quota for messages, requests, and exports, plus the reset date. “How much Grupy quota do I have left?” All plans

Summary historylist_summaries

Shows your summary history, with filters for group, date, and status. “Show the failed summaries for the Class of 2012 Alumni group this month.” All plans

Group detailsget_group

Shows the details of one group: schedule, language, number of stored members, last message, and number status. “When did the last message arrive in the Class 4B Parents group, and what is its schedule?” All plans

List Fathom meetingslist_meetings

Shows the Fathom meetings that are connected to your account. “Show my Fathom meetings this week.” All plans

Read Fathom meetingget_meeting

Reads the summary of one Fathom meeting. “Read the summary of my latest Fathom meeting.” All plans

Automation rulesget_automation

Shows the join request automation rules of a group. “What are the join request automation rules in the New Community group?” All plans

Join requestslist_join_requests

Shows pending join requests, with masked numbers and the expected decision. “Who is waiting to join the New Community group?” All plans

Join decision historylist_join_decisions

Shows the history of automated join request decisions. “Show the automated decisions that were rejected in the New Community group.” All plans

Goakal transactionslist_goakal_transactions

Shows Goakal transactions: service, amount, payment time, and masked number. “Show the latest Goakal transactions.” All plans

Webhook statuslist_webhooks

Shows the status of your account's webhook endpoints. “Are all my webhooks still active?” All plans

Search messagessearch_messages

Searches for a word in the stored messages of one group. Only appears after the Read messages permission is turned on. “Search for ‘exam schedule’ in the Class 4B Parents group this month.” All plans · message reading permission

Decide join requestdecide_join_request

Accepts or rejects one join request. Only appears after the Manage join requests permission is turned on. “Accept the first join request in the New Community group.” All plans · manage join requests permission

Set join request automationset_automation

Turns join request automation on or off, or turns Simulation on or off, for one active group. Send enabled, dry_run, or both. Simulation only records decisions. When dry_run is false, Grupy accepts and declines real join requests by your rules, and nobody can undo those decisions. A group without automation starts in Simulation. This tool does not change rules. Change rules in the dashboard. Only appears after the Manage join requests permission is turned on. “Turn on join request automation in the New Community group, in Simulation.” All plans · manage join requests permission

Refresh group listsync_groups

Refreshes the group list of one WhatsApp number from WhatsApp now. Send number_id from list_numbers, or leave it out when the account has one number. New groups stay off until you turn them on with activate_groups. A group that the number has left turns off. The result status is done, running, or rate_limited. If it is rate_limited, try again at retry_at. Only appears after the Manage groups permission is turned on. “Refresh the group list of my WhatsApp number.” All plans · manage groups permission

Turn on groupsactivate_groups

Turns on 1 to 50 groups at once (by ID or name), so Grupy starts to save their messages and run their summary schedules. Follows the group limit of your plan for each number. Only appears after the Manage groups permission is turned on. “Turn on the Alumni 2012 and Class 4B Parents groups.” All plans · manage groups permission

Turn off groupsdeactivate_groups

Turns off 1 to 50 groups at once. While a group is off, new messages from it are not saved. Only a history import can fetch them later. Summary schedules and a running history import stop. Messages that are already saved stay, within your plan limit. Only appears after the Manage groups permission is turned on. “Turn off the Old Project group.” All plans · manage groups permission

Change summary scheduleupdate_group_schedule

Changes the summary schedule of one group: daily summary, time, and time zone. Only the fields you send change. The schedule rules of your plan apply. Only appears after the Manage groups permission is turned on. “Set the summary of the Class 4B Parents group to 20:00 Jakarta time.” All plans · manage groups permission

Change summary languageset_summary_language

Changes the language of new summaries for the whole account: auto (follows the chat language), id, en, es, pt, it, de, nl, ar, or ms. Existing and queued summaries keep their language. The display language of the dashboard does not change. Only appears after the Manage groups permission is turned on. “Write my next summaries in English.” All plans · manage groups permission

Example prompts

Copy a prompt, then paste it into your AI assistant. Swap in your own group names.

Morning “Show the groups I turned on, along with their summary schedules.”

Decisions “What decisions were made in the Block Party Committee group this week?”

Tasks “Are there any tasks assigned to me in the Office group?”

Schedule “When is the reunion scheduled in the Class of 2012 Alumni group?”

History “Show the failed summaries for the Class of 2012 Alumni group this month.”

Quota “How much Grupy quota do I have left this month?”

Limits and quota

The free plan works with an AI assistant. These are its limits.

Feature Free

WhatsApp numbers 1

Groups 3

Messages per month 5,000

Connected AI assistants All

Paid plans raise these limits. Open your account page after you sign in to see them.

Info Quota from your AI assistant and the dashboard is counted together and resets at the start of each month. Ask “How much Grupy quota do I have left?” to check.

Security and privacy

Your AI assistant can only read. Grupy never sends messages on your behalf.

What it can do

✓Read the list of groups you chose

✓Read summaries and key points

✓Read your summary history

✓See your remaining quota

What it cannot do

✕Send or reply to messages

✕Read groups you did not choose

✕Delete groups or members

✕Read chat content that has been deleted

Revoke access at any time

1. Open the dashboard and choose Settings › AI access. 2. Find the assistant or key you want to stop. 3. Click Revoke. Access stops immediately.

ClaudeConnected Oct 2Revoke

Key “Hermes laptop”Used 3 hours agoRevoke

Troubleshooting

Make sure you finished the Approve step. Close your AI assistant and open it again. If Grupy still does not show up, remove the connector and add it again.

Still not working?Send a message to halo@grupy.chat with the name of your AI assistant and a screenshot of the error.

grupy.chatDocs

Documentation›MCP›Connect an AI assistant

MCP server

Connect Grupy to your AI assistant

Ask about your WhatsApp groups right from Claude, ChatGPT, or another AI agent. Grupy reads and summarizes, and your assistant just answers.

Updated Oct 2, 2026 · 4 min read

Quick start

± 2 min

1 Copy the server URL

mcp.grupy.chat

2 Add it to your AI assistant Open the Connectors or MCP settings, then paste the URL.

3 Log in and approve Log in to Grupy and click Approve. Hermes and other agents use an access key.

Connect an AI assistant

Pick the assistant you use. Claude and ChatGPT only need the URL. Hermes, OpenClaw, and other agents need an access key.

See all supported apps

Connect to Claude

URL only

Add Grupy as a connector with the URL, then log in to Grupy and approve. No access key needed.

Info You do not need an access key. The server URL and a login to your Grupy account are enough.

1

Open the Connectors menu

In Claude, open Settings, choose Connectors, then click Add custom connector.
2

Paste the server URL

Enter Grupy as the name, paste the URL below, then click Add.

Server URL https://mcp.grupy.chat/mcp
3

Log in to Grupy

Claude opens the Grupy page. Log in with the same Google account you use for your dashboard.
4

Approve access Check the permissions, then click Approve. Grupy shows up in Claude's tool list right away.
Tip Try asking: "Which groups did I turn on for summaries?"

Connect to ChatGPT

URL only

Add Grupy as a connector with the server URL. You only log in and approve once.

Important The connector menu can differ depending on your ChatGPT plan. If it does not show up, check your ChatGPT account settings.

1

Open the Connectors menu

In ChatGPT, open Settings, choose Connectors, then click Add connector.
2

Paste the server URL

Enter Grupy as the name, paste the URL below, then click Add.

Server URL https://mcp.grupy.chat/mcp
3

Log in and approve

Log in with your Google account, check the permissions, then click Approve. Grupy is ready to use in a new chat.

Tip Try asking: "Summarize the Class 4B Parents group since yesterday."

Connect to Hermes

URL + access key

Hermes connects with the server URL and an access key that you create in your Grupy dashboard.

Info Hermes needs two things: the server URL and an access key from your Grupy dashboard.

1

Create an access key

In your Grupy dashboard, open Settings, choose AI access, then click Create new key. Name it "Hermes" so it is easy to recognize.
2

Copy the server URL and the key

The full key is shown only once. Store it somewhere safe.

Server URL https://mcp.grupy.chat/mcp

Access key gk_live_••••••••••••••••••••gk_live_7Hq2mX9pR4tL8vNc3sWd

Important Do not share your access key. Anyone who holds this key can read your group summaries. If it leaks, revoke it in the dashboard.
3

Paste it into Hermes

Open the MCP settings in Hermes, add a new server, then enter the server URL and the access key.
4

Try your first prompt Ask anything about your groups. If it works, Hermes calls a Grupy tool.
Tip Use the group name exactly as it appears in WhatsApp so the result is accurate.

Connect to OpenClaw

URL + access key

OpenClaw connects with the server URL and an access key that you create in your Grupy dashboard.

Info OpenClaw needs two things: the server URL and an access key from your Grupy dashboard.

1

Create an access key

In your Grupy dashboard, open Settings, choose AI access, then click Create new key. Name it "OpenClaw" so it is easy to recognize.
2

Copy the server URL and the key

The full key is shown only once. Store it somewhere safe.

Server URL https://mcp.grupy.chat/mcp

Access key gk_live_••••••••••••••••••••gk_live_7Hq2mX9pR4tL8vNc3sWd

Important Do not share your access key. Anyone who holds this key can read your group summaries. If it leaks, revoke it in the dashboard.
3

Paste it into OpenClaw

In OpenClaw, open the Tools or MCP settings, add a server, then enter the server URL and the access key.
4

Try your first prompt Ask anything about your groups. If it works, OpenClaw calls a Grupy tool.
Tip Use the group name exactly as it appears in WhatsApp so the result is accurate.

Connect to Other agent

URL + access key

For any app or agent that supports MCP over HTTP.

Info Works in any app that supports MCP servers over HTTP.

1

Create an access key

In your Grupy dashboard, open Settings, choose AI access, then click Create new key. Name it "Other agent" so it is easy to recognize.
2

Copy the server URL and the key

The full key is shown only once. Store it somewhere safe.

Server URL https://mcp.grupy.chat/mcp

Access key gk_live_••••••••••••••••••••gk_live_7Hq2mX9pR4tL8vNc3sWd

Important Do not share your access key. Anyone who holds this key can read your group summaries. If it leaks, revoke it in the dashboard.
3

Paste it into your agent

Find the MCP menu in your app. Enter the server URL, then send the key as an Authorization header as shown below.

Header Authorization: Bearer gk_live_••••••••••••••••••••
4

Try your first prompt Ask anything about your groups. If it works, your agent calls a Grupy tool.
Tip Use the group name exactly as it appears in WhatsApp so the result is accurate.

Available tools

Your AI assistant calls these tools on its own. You just ask in plain language.

List groupsAll plans

list_groups Shows the ID, name, and summary schedule of the groups in your account, with a filter for active (default), inactive, or all groups. “Show the groups I turned on, along with their summary schedules.”

List numbersAll plans

list_numbers Shows each WhatsApp number in the account with a masked number, its status, its active groups, the group limit of your plan, and its free group slots. “How many free group slots do I have on my WhatsApp number?”

Read stored messagesAll plans · message reading permission

read_messages Reads stored text from your active groups after you allow message reading on the MCP page. The AI you connected can summarize it on its own. “Read the stored messages from the group I chose over the last 24 hours, then summarize them with this AI.”

Group summaryAll plans

summarize_group Queues a summary task for one group over a given time range. “Summarize the Class 4B Parents group since yesterday, then read the result when it is done.”

Cross-group summaryHigher plans

summarize_groups Queues one summary task for each group you select. “Summarize the work groups I picked for this week, then read the result for each group.”

Read summary resultAll plans

get_summary Reads the status and result of one of your summary tasks by summary_id. “Check the summary task from earlier and show me the result if it is finished.”

Search summariesAll plans

search Searches the text of the finished summaries in your account, newest first, up to 20 results. Each result has an id, a title, and a link to the summary in the dashboard. ChatGPT deep research uses it most. “Search my summaries for the monthly dues.”

Get summary textAll plans

fetch Gets the full text of one summary in your account by an id from search. The result has the id, title, text, link, and metadata. An unknown id, or an id from another account, gives not found. “Open the summary from that search and explain the decisions.”

Cancel summaryAll plans

cancel_summary Cancels one pending or running summary of your account by summary_id. A cancelled summary does not use summary quota. A finished summary cannot be cancelled. “Cancel the Class 4B Parents summary that is still running.”

Export numbersAll plans

export_members Creates a CSV of group members after you approve the export in the dashboard. Hidden numbers are still marked. “Export the members of the Class of 2012 Alumni group to CSV.”

Check quotaAll plans

check_quota Shows your plan, your usage, and your remaining quota for messages, requests, and exports, plus the reset date. “How much Grupy quota do I have left?”

Summary historyAll plans

list_summaries Shows your summary history, with filters for group, date, and status. “Show the failed summaries for the Class of 2012 Alumni group this month.”

Group detailsAll plans

get_group Shows the details of one group: schedule, language, number of stored members, last message, and number status. “When did the last message arrive in the Class 4B Parents group, and what is its schedule?”

List Fathom meetingsAll plans

list_meetings Shows the Fathom meetings that are connected to your account. “Show my Fathom meetings this week.”

Read Fathom meetingAll plans

get_meeting Reads the summary of one Fathom meeting. “Read the summary of my latest Fathom meeting.”

Automation rulesAll plans

get_automation Shows the join request automation rules of a group. “What are the join request automation rules in the New Community group?”

Join requestsAll plans

list_join_requests Shows pending join requests, with masked numbers and the expected decision. “Who is waiting to join the New Community group?”

Join decision historyAll plans

list_join_decisions Shows the history of automated join request decisions. “Show the automated decisions that were rejected in the New Community group.”

Goakal transactionsAll plans

list_goakal_transactions Shows Goakal transactions: service, amount, payment time, and masked number. “Show the latest Goakal transactions.”

Webhook statusAll plans

list_webhooks Shows the status of your account's webhook endpoints. “Are all my webhooks still active?”

Search messagesAll plans · message reading permission

search_messages Searches for a word in the stored messages of one group. Only appears after the Read messages permission is turned on. “Search for ‘exam schedule’ in the Class 4B Parents group this month.”

Decide join requestAll plans · manage join requests permission

decide_join_request Accepts or rejects one join request. Only appears after the Manage join requests permission is turned on. “Accept the first join request in the New Community group.”

Set join request automationAll plans · manage join requests permission

set_automation Turns join request automation on or off, or turns Simulation on or off, for one active group. Send enabled, dry_run, or both. Simulation only records decisions. When dry_run is false, Grupy accepts and declines real join requests by your rules, and nobody can undo those decisions. A group without automation starts in Simulation. This tool does not change rules. Change rules in the dashboard. Only appears after the Manage join requests permission is turned on. “Turn on join request automation in the New Community group, in Simulation.”

Refresh group listAll plans · manage groups permission

sync_groups Refreshes the group list of one WhatsApp number from WhatsApp now. Send number_id from list_numbers, or leave it out when the account has one number. New groups stay off until you turn them on with activate_groups. A group that the number has left turns off. The result status is done, running, or rate_limited. If it is rate_limited, try again at retry_at. Only appears after the Manage groups permission is turned on. “Refresh the group list of my WhatsApp number.”

Turn on groupsAll plans · manage groups permission

activate_groups Turns on 1 to 50 groups at once (by ID or name), so Grupy starts to save their messages and run their summary schedules. Follows the group limit of your plan for each number. Only appears after the Manage groups permission is turned on. “Turn on the Alumni 2012 and Class 4B Parents groups.”

Turn off groupsAll plans · manage groups permission

deactivate_groups Turns off 1 to 50 groups at once. While a group is off, new messages from it are not saved. Only a history import can fetch them later. Summary schedules and a running history import stop. Messages that are already saved stay, within your plan limit. Only appears after the Manage groups permission is turned on. “Turn off the Old Project group.”

Change summary scheduleAll plans · manage groups permission

update_group_schedule Changes the summary schedule of one group: daily summary, time, and time zone. Only the fields you send change. The schedule rules of your plan apply. Only appears after the Manage groups permission is turned on. “Set the summary of the Class 4B Parents group to 20:00 Jakarta time.”

Change summary languageAll plans · manage groups permission

set_summary_language Changes the language of new summaries for the whole account: auto (follows the chat language), id, en, es, pt, it, de, nl, ar, or ms. Existing and queued summaries keep their language. The display language of the dashboard does not change. Only appears after the Manage groups permission is turned on. “Write my next summaries in English.”

Example prompts

Copy a prompt, then paste it into your AI assistant. Swap in your own group names.

Morning “Show the groups I turned on, along with their summary schedules.”

Decisions “What decisions were made in the Block Party Committee group this week?”

Tasks “Are there any tasks assigned to me in the Office group?”

Schedule “When is the reunion scheduled in the Class of 2012 Alumni group?”

History “Show the failed summaries for the Class of 2012 Alumni group this month.”

Quota “How much Grupy quota do I have left this month?”

Limits and quota

The free plan works with an AI assistant. These are its limits.

Feature Free

WhatsApp numbers 1

Groups 3

Messages per month 5,000

Connected AI assistants All

Paid plans raise these limits. Open your account page after you sign in to see them.

Info Quota from your AI assistant and the dashboard is counted together and resets at the start of each month. Ask “How much Grupy quota do I have left?” to check.

Security and privacy

Your AI assistant can only read. Grupy never sends messages on your behalf.

What it can do

✓Read the list of groups you chose

✓Read summaries and key points

✓Read your summary history

✓See your remaining quota

What it cannot do

✕Send or reply to messages

✕Read groups you did not choose

✕Delete groups or members

✕Read chat content that has been deleted

Revoke access at any time

1. Open the dashboard and choose Settings › AI access. 2. Find the assistant or key you want to stop. 3. Click Revoke. Access stops immediately.

ClaudeConnected Oct 2Revoke

Key “Hermes laptop”Used 3 hours agoRevoke

Troubleshooting

Make sure you finished the Approve step. Close your AI assistant and open it again. If Grupy still does not show up, remove the connector and add it again.

Still not working?Send a message to halo@grupy.chat with the name of your AI assistant and a screenshot of the error.

Was this page helpful?