---
title: "Teams for AI apps"
description: "Let Claude, ChatGPT or Cursor list teams, read a team's home and brief, put pages and meetings into teams, and ask one team's space."
canonical_url: https://docs.markdrop.in/teams/for-ai-apps
last_updated: 2026-11-19
prerequisites: [/ai/hosted-mcp]
site: "Markdrop Docs"
index: https://docs.markdrop.in/llms.txt
---

# Teams for AI apps

Everything on these pages works from an AI app connected to Markdrop's [hosted MCP server](https://docs.markdrop.in/ai/hosted-mcp). The app acts as you, with your access: it sees the teams and content you can see, and can only change what you could on the website.

## Try asking

> What did the Sales team ship and decide last week?

`get_team_brief` reads Sales's latest brief.

> Move "Q4 pricing playbook" into Sales, and also share it with Marketing.

`move_to_team`, then `share_to_team`.

> Which teams does the Northwind renewal call belong to? Put it in Sales only.

`route_meeting` with `teams: ["Sales"]`.

> Ask Engineering what's blocking SSO.

`ask_documents` with `space: "team:<id>"` (from `list_teams`).

## Tools

| Tool | Read or write | What it does | Arguments |
| --- | --- | --- | --- |
| `list_teams` | read | The workspace's teams: name, open or private, size, and whether you're in it. | `workspace` |
| `get_team` | read | A team's home: its latest brief, members, recent pages, meetings and projects. A private team you're not in: its name and brief. | `workspace`, `team` (id, slug or name) |
| `get_team_brief` | read | A team's weekly brief, this week's or an earlier one. Every workspace member can read it. | `workspace`, `team`, `week` |
| `list_projects` | read | Cross-team projects you can open, or one team's. | `workspace`, `team` |
| `create_team` | write | Workspace admins: a new open or private team, with its leads and members. | `workspace`, `name`, `visibility`, `description`, `leads`, `members` |
| `update_team` | write | Leads and admins: name, description, Slack channel, comment posts to the channel (`slack_comments`), Jira projects, digest; admins also open or private. | `workspace`, `team`, … |
| `add_team_members` | write | Leads and admins add workspace members; anyone can add themselves to an open team. | `workspace`, `team`, `people` |
| `remove_team_members` | write | Leads and admins remove people; anyone can remove themselves (`"me"`). | `workspace`, `team`, `people` |
| `move_to_team` | write | Puts a document, page or file into one team, or back to General, the team everyone is in (`team: "General"` or `"company"`). | `document`, `team` |
| `move_folder_to_team` | write | Moves a folder with everything in it to another team. Workspace-visible items become visible to that team only; private items stay private; people shares and public links keep working (listed). `dry_run: true` only reports the counts. Admins, or a lead of the folder's team who is in the target team. | `workspace`, `path`, `team`, `parent`, `dry_run` |
| `share_to_team` | write | Adds a team to an item's teams, or takes one off (`remove: true`). | `document`, `team`, `remove` |
| `edit_team_brief` | write | Leads and admins: change, hide or add a line of the brief. | `workspace`, `team`, `line_id`, `text`, `hidden`, `add` |
| `create_project` | write | A project shared by several teams. | `workspace`, `name`, `teams` |
| `route_meeting` | write | Says which teams a meeting belongs to (its page and transcript follow). | `meeting`, `teams` |
| `my_todos` | read | Your [to-do pages](https://docs.markdrop.in/teams/to-dos), one per team: your open action items from the team's calls, by company. | `workspace`, `team`, `include_done` |
| `team_todos` | read | Team leads: every member's open to-dos in the team. | `workspace`, `team`, `person` |
| `tick_todo` | write | Ticks one of your to-dos, or opens it again with `done: false`. The call's action item follows. | `item`, `done` |
| `refresh_my_todos` | write | Creates your to-do page in a team, or refreshes it now: your action items from the team's calls and the tasks on its pages that mention you. Returns how many items are new and open. | `team`, `workspace` |
| `team_backlog` | read | A team's shared backlog: every action item and customer ask from its calls by category (feature request, bug, improvement, task, follow-up, question), with status, owner, company and how many calls mentioned it. Only items from calls you can open. | `team`, `workspace`, `category`, `status`, `company`, `include_done` |
| `update_backlog_item` | write | Changes a backlog item's category, status, owner or text. Your change wins over the automatic sorting; marking it done ticks the call's action item. | `id`, `category`, `status`, `owner`, `text` |
| `refresh_team_backlog` | write | Team leads: re-reads every call in the team into its backlog now and rewrites the page. Returns how many items are new and open. | `team`, `workspace` |
| `list_favorites` | read | The pages, files, teams and projects you starred in a workspace (the sidebar's Favorites). | `workspace` |
| `set_favorite` | write | Stars or unstars a page or file (`kind: "doc"`), a team or a project. | `workspace`, `kind`, `item`, `on` |

`search`, `ask_documents`, `ask_meetings`, `list_team`, `get_person_profile`, `get_project_status`, `list_workspace_items` and `list_meetings` take a `space`: `team:<id>`, `project:<id>`, `company` (General: items in no other team) or `all` (the default: everything you can read). See [All tools](https://docs.markdrop.in/ai/tools#teams).
