> This page is for Agent Handler. > For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://docs.merge.dev/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.merge.dev/_mcp/server. # RingCentral **Authentication:** OAuth. See [Magic Link](/merge-agent-handler/features/magic-link) for the runtime auth flow, or [Application credentials](/merge-agent-handler/admin-setup/add-oauth-credentials) to bring your own OAuth app. ## Sample use cases * Post the release notes to the `Engineering` team chat * List the open tasks in the `Support Escalations` chat and who each is assigned to * Create a team for the `Q3 Launch` project and add its members ## Available Tools #### add_team_members Add members to a RingCentral team by person ID. Reverse with remove_team_members. Person IDs come from a chat's membe... #### archive_team Archive a RingCentral team (make it read-only). Reverse with unarchive_team. Use list_teams to find team IDs. #### complete_task Complete or reopen a RingCentral task. Check completenessCondition with get_task first. Simple: pass status. AllAssig... #### create_chat_note Create a note in a RingCentral chat. title is required. Use list_chats to find chat IDs. Returns the created note wit... #### create_conversation Open or create a RingCentral conversation with the given member person IDs. Returns the existing conversation if one... #### create_post Post a message to a RingCentral chat. text is required. Use list_chats to find chat IDs. Returns the created post wit... #### create_task Create a task in a RingCentral chat. subject and assignees are required - a task cannot be unassigned. Assignee IDs c... #### create_team Create a RingCentral team. name is required. Pass member person IDs to seed it. Person IDs come from a chat's members... #### delete_note Delete a RingCentral note permanently. Use list_chat_notes to find note IDs. #### delete_post Delete a RingCentral post permanently. Use list_posts to find post IDs. #### delete_task Delete a RingCentral task permanently. To mark it done instead, use complete_task. Use list_chat_tasks to find task IDs. #### delete_team Delete a RingCentral team permanently. Use list_teams to find team IDs. #### favorite_chat Add a RingCentral chat to the authenticated person's favorites. Reverse with unfavorite_chat. Use list_chats to find... #### get_chat Get one RingCentral chat by ID, including its members. Use list_chats to find chat IDs. #### get_conversation Get one RingCentral conversation by ID, including its members. Use list_conversations to find conversation IDs. #### get_current_person Get the profile of the currently authenticated RingCentral person (the '\~' account). #### get_note Get one RingCentral note by ID, including its body. Use list_chat_notes to find note IDs. #### get_person Get a RingCentral person by ID. Person IDs appear in the members, creator, and assignees fields of chats, notes, and... #### get_post Get one RingCentral post by ID within a chat. Use list_posts to find post IDs. #### get_task Get one RingCentral task by ID, including assignees and due date. Use list_chat_tasks to find task IDs. #### get_team Get one RingCentral team by ID. Use list_teams to find team IDs. #### join_team Join a public RingCentral team as the authenticated person. Reverse with leave_team. Use list_teams to find team IDs. #### leave_team Leave a RingCentral team as the authenticated person. Reverse with join_team. Use list_teams to find team IDs. #### list_chat_notes List notes in a RingCentral chat. Filter server-side by status (Active, Draft), creator_id, and creation time range... #### list_chat_tasks List tasks in a RingCentral chat. Filter server-side by status (Pending, InProgress, Completed), creator_id, assignee... #### list_chats List RingCentral chats. Filter server-side by type (Everyone, Team, Group, Direct, Personal). Use this to find chat I... #### list_conversations List the authenticated person's RingCentral conversations. Use this to find conversation IDs. Page forward with page\_... #### list_favorite_chats List the authenticated person's favorite RingCentral chats. Use favorite_chat to add and unfavorite_chat to remove. R... #### list_posts List posts (messages) in a RingCentral chat. Use list_chats to find chat IDs. Page forward with page_info.next_page_t... #### list_recent_chats List the authenticated person's recent RingCentral chats, most recent first. Filter by type. Raise record_count for m... #### list_teams List RingCentral teams the authenticated person can see. Use this to find team IDs. Page forward with page_info.next\_... #### lock_note Lock a RingCentral note for editing so others cannot change it. Reverse with unlock_note. Use list_chat_notes to find... #### publish_note Publish a RingCentral note (move it from Draft to Active). Use list_chat_notes to find note IDs. #### remove_team_members Remove members from a RingCentral team by person ID. Reverse with add_team_members. Current member IDs come from get\_... #### unarchive_team Unarchive a RingCentral team (restore write access). Reverse with archive_team. Use list_teams to find team IDs. #### unfavorite_chat Remove a RingCentral chat from the authenticated person's favorites. Reverse with favorite_chat. Use list_favorite_ch... #### unlock_note Unlock a RingCentral note so it can be edited by others. Reverse with lock_note. Use list_chat_notes to find note IDs. #### update_note Update a RingCentral note's title or body. Only supplied fields change. Set release_lock true to release the edit loc... #### update_post Edit the text of a RingCentral post. Only the post author can edit. Use list_posts to find post IDs. #### update_task Update a RingCentral task. Only supplied fields change. To close it, use complete_task. New assignee IDs come from a... #### update_team Update a RingCentral team's name, description, or visibility. Only supplied fields change. Use list_teams to find tea...