MCP Tools Reference
AB Projects exposes MCP tools that let AI assistants (such as Claude) work with your projects, tasks, and documents. When an assistant changes something through these tools, it goes through the same path as the app: a change-history entry with the note you provide, an audit log entry, and an Adaptive Card posted to the linked Microsoft Teams channel — with AI activity clearly disclosed. Read-only tools just return data and change nothing.
Project Tools
| Tool | Description | Parameters |
|---|---|---|
ab_get_my_projects |
List all projects you are a member of, including stats such as task counts and completion rates. | None |
ab_get_project_members |
List all members of a project with their roles and membership IDs. Use this to get the membership ID needed to assign a task. | project_id required |
ab_get_project_options |
Get the valid status, type, and environment IDs for a project. Call this first before passing a status, type, or environment to ab_create_task or ab_update_task. |
project_id required |
Task Tools
| Tool | Description | Parameters |
|---|---|---|
ab_get_my_tasks |
Get your active tasks — overdue, due today, and in progress. Returns task ID, title, priority, status, due date, and progress. | project_id optional — filter to a specific project |
ab_search_tasks |
Search tasks by keyword across all your projects. | query required — search keyword project_id optional — scope to a specific project |
ab_get_task |
Get full details of a task — description, dates, assignee, estimate/actual hours, subtask info, parent task ID, GitHub branch, and the most recent 50 comments inline. Status, type, and environment are returned as human-readable names. | project_id required task_id required |
ab_create_task |
Create a new task. A change-log entry is recorded and a notification is posted to the linked Teams channel. | project_id required title required description optional — supports Markdown priority optional — 1 = High, 2 = Medium, 3 = Low (default: 2) assignee_id optional — membership ID of the assignee due_date optional — yyyy-MM-dd status / type / environment optional — IDs from ab_get_project_optionsparent_task_id optional — row key of the parent; when set, this becomes a subtask and the parent's "has subtasks" flag updates automatically note optional — reason, shown in the change log and Teams channel |
ab_update_task |
Update a task's properties — title, description, status, progress, priority, assignee, type, environment, or parent. Each change is recorded in history with the provided note. | project_id required task_id required title / description optional (Markdown) status optional — new status ID progress optional — 0 to 100 priority optional — 1/2/3 assignee_id / type / environment optional parent_task_id optional — move under a different parent; empty string to detach note optional — reason, shown in the change log and Teams channel |
ab_complete_task |
Mark a task complete. Sets progress to 100% and records a completion entry in the change history. | project_id required task_id required note optional — completion note, shown in the change log and Teams channel |
ab_add_comment |
Add a comment to a task. The comment appears in the task's thread and is inlined by ab_get_task, so a follow-up call can read it without a second tool call. |
project_id required task_id required content required — comment text |
Schedule Tools
| Tool | Description | Parameters |
|---|---|---|
ab_get_schedule |
Get your schedule for the current week — grouped into overdue, due today, and due this week. | project_id optional — filter to a specific project |
Documents (Wiki) Tools
| Tool | Description | Parameters |
|---|---|---|
ab_get_wiki_tree |
Get the Documents navigation tree (folders and pages) for a project. | project_id required |
ab_get_wiki_article |
Read a document's full content, metadata, and version info. | project_id required article_id required — from ab_get_wiki_tree or ab_search_wiki |
ab_search_wiki |
List documents under a specific folder path. | project_id required parent_path optional — folder to list from (default: / for root) |
ab_create_wiki_article |
Create a new document in Markdown. Posts a notification to the linked Teams channel. | project_id required title required content required — Markdown parent_path optional — folder, e.g. / or /Engineering (default: /)tags optional — comma-separated |
ab_update_wiki_article |
Update an existing document. Creates a new version with an edit note and posts a notification to the Teams channel. | project_id required article_id required content required — updated Markdown edit_note required — what changed; shown in version history tags optional — updated comma-separated tags |
ab_add_wiki_comment |
Add a comment to a document. | project_id required article_id required content required — comment text |
How AI changes stay visible
When a task or document is created, updated, or completed through an MCP tool, AB Projects automatically:
- Records the change in the item's change history with the user's name and the provided note
- Writes an operation-log entry for audit purposes
- Posts or updates an Adaptive Card in the project's linked Microsoft Teams channel, with the activity clearly disclosed as AI-generated
So AI-driven changes carry the same visibility and traceability as changes made directly in the AB Projects app or Teams tab. For how to connect an assistant, see Connecting AI Assistants via MCP.