Skip to main content
Glama

asana-admin-mcp

MCP-сервер для структурирования Asana — портфолио, пользовательские поля / dropdown, проекты, секции. Заполняет пробелы, которые стандартный коннектор Asana не умеет (тот ориентирован на задачи/чтение).


⚠️ Dashboard не работает — и это не ограничение данного MCP

Asana не предоставляет публичный API для Dashboard / chart / widget / project view tab вообще (проверили все 175 endpoints в официальной OpenAPI-спецификации — ни одного нет).

Единственный способ автоматизировать — project_duplicate: согласно спецификации, при дублировании проекта Project Views (вкладки List / Board / Dashboard) копируются всегда, и это нельзя отключить. → Настройте Dashboard в одном «проекте-шаблоне» и дублируйте его каждый раз, когда нужен новый проект.

🟡 Ещё не доказано: в спецификации сказано, что «Project Views» копируются, но не указано явно, копируются ли настроенные в Dashboard чарты или только пустые вкладки — через API это не проверить (нет endpoint для чтения chart), нужно смотреть глазами. smoke test от 2026-08-17 дублировал проект без chart, поэтому этот вопрос остаётся открытым.

Примечание: Project Template не переносит Dashboard (это до сих пор висит как feature request на форуме Asana). Нужно использовать duplicate, а не template.


Related MCP server: asana-mcp

Установка

1. Сначала получите Asana token (у каждого должен быть свой)

Следуйте GET-TOKEN.md → сохраните в ~/.asana_token

printf '%s' 'วาง_token_ตรงนี้' > ~/.asana_token && chmod 600 ~/.asana_token

token привязан к правам конкретного пользователя — нельзя использовать чужой — в логах Asana будет виден владелец token.

2. Установка плагина (рекомендуется)

В Claude Code введите две строки:

/plugin marketplace add plakorp/asana-admin-mcp
/plugin install asana-admin@asana-admin-mcp

Claude Code сам склонирует репозиторий, выполнит npm ci и зарегистрирует MCP — трогать ~/.claude.json не нужно. Обновление позже: /plugin update.

На машине нужен Node 20+ (проверьте через node -v).

Способ 2 — ручная установка (если не хотите использовать плагин)

Склонируйте репозиторий и дважды кликните ติดตั้ง-asana-admin-mcp.command Скрипт запросит token, выполнит npm install и запишет ~/.claude.json (каждый раз с резервной копией).

Не используйте оба способа одновременно — получится два дублирующихся MCP с именем asana-admin.

Token сначала читается из env ASANA_TOKEN; если его нет — fallback на ~/.asana_token. → token никогда не хранится в репозитории и не должен попадать в ~/.claude.json.


Инструменты (21)

Все инструменты принимают gid, а не имя — используйте asana_find, чтобы преобразовать имя → gid.

Поиск

Инструмент

Описание

asana_whoami

кто вы + все workspace (начните здесь: почти для любого create нужен workspace_gid)

asana_find

typeahead поиск gid по имени — project / portfolio / custom_field / task / team / user / tag / goal

asana_list_custom_fields

пользовательские поля в workspace или привязанные к project/portfolio — возвращает enum_options с gid, это входные данные для всех инструментов группы dropdown

Портфолио

Инструмент

Описание

portfolio_create

создать портфолио

portfolio_update

переименовать / изменить цвет / public

portfolio_list_items

просмотреть проекты в портфолио в порядке фактического отображения

portfolio_add_item

добавить проект в портфолио + можно указать позицию (insert_before / insert_after) — повторный вызов с уже существующим item = переместить

portfolio_remove_item

убрать проект (требуется передать confirm: true)

Пользовательские поля / dropdown

Инструмент

Описание

custom_field_create

создать поле — enum (dropdown с выбором одного значения) / multi_enum / text / number / date / people

custom_field_update

переименовать / изменить description

enum_option_create

добавить значение в dropdown + можно указать позицию

enum_option_update

переименовать / изменить цвет / enabled:false для отключения

enum_option_reorder

изменить порядок значений в dropdown

custom_field_attach

привязать поле к project или portfolio (is_important:true = показывать как колонку)

Asana не позволяет удалить значение dropdown — можно только enabled:false; задачи, где это значение уже выбрано, сохранят прежнее значение.

Проект / Секция

Инструмент

Описание

project_create

создать проект (в организации обязателен team_gid)

project_update

переименовать / notes / цвет / default_view / archive

project_duplicate

скопировать проект вместе с Dashboard — единственное решение вопроса dashboard (возвращает job, работает async)

project_list_sections

секции в порядке отображения + gid

section_create

добавить секцию + можно указать позицию

section_update

переименовать секцию

section_reorder

изменить порядок секций

Намеренно нет инструментов для удаления проектов / портфолио / пользовательских полей — их невозможно восстановить, делайте это в веб-интерфейсе.


Цвета (доступны для портфолио / проекта / enum option)

none red orange yellow-orange yellow yellow-green green blue-green aqua blue indigo purple magenta hot-pink pink cool-gray


Тестирование

ASANA_TOKEN=$(cat ~/.asana_token) npm run smoke

Создаёт реальные объекты в первом workspace токена с именами, начинающимися на ZZ-mcp-smoke-* → проверяет все инструменты → удаляет всё сам. Если token не указан, выполняется только первая половина (server boot + list tools).


Примечания по работе

  • 429 → автоматический retry 3 раза согласно Retry-After

  • ошибки Asana возвращаются как настоящие сообщения API (указывают, какого поля не хватает / какой gid неверный), а не просто status code

  • неотправленные поля не затрагиваются — portfolio_update, которому передан только name, не очищает цвет

Available Tools

23 tools
asana_findFind gid by nameA

Typeahead search that turns a name you can see in the Asana UI into the gid every other tool needs.

Inputs: type (required), query (required), workspace_gid (required), count.

asana_list_custom_fieldsList custom fieldsA

Custom fields in a workspace, or the ones attached to a project/portfolio. Returns enum_options with their gids — the input for every dropdown tool.

Inputs: project_gid, portfolio_gid, workspace_gid.

asana_whoamiWho am IA

The authenticated user and their workspaces. Call this first — almost every create call needs a workspace_gid.

Inputs: no named parameters.

custom_field_attachAttach custom field to project or portfolioB

Make an existing custom field available on a project or a portfolio.

Inputs: custom_field_gid (required), project_gid, insert_after, is_important, +2 more.

custom_field_createCreate custom fieldB

Create a workspace custom field. For a dropdown use type 'enum' (single-select) or 'multi_enum' (multi-select) and pass enum_options.

Inputs: name (required), type (required), workspace_gid (required), precision, +2 more.

custom_field_updateRename / update custom fieldA

Change a custom field's name or description. Enum values are edited with the enum_option_* tools.

Inputs: custom_field_gid (required), name, description.

enum_option_createCreate dropdown valueA

Add a value to an enum / multi_enum custom field. Appended at the end unless you give a position.

Inputs: name (required), custom_field_gid (required), color, insert_after, +1 more.

enum_option_reorderReorder dropdown valueA

Move an existing dropdown value to a new position within its custom field.

Inputs: enum_option_gid (required), custom_field_gid (required), after_enum_option, before_enum_option.

enum_option_updateRename / disable dropdown valueA

Rename, recolor, or disable a dropdown value. Asana has no delete — set enabled:false to retire a value; tasks already holding it keep it.

Inputs: enum_option_gid (required), name, color, enabled.

member_addAdd member to project or portfolioA

Give a person or team access to a project or portfolio. NOTE Asana's own limits: a project can only be admin / editor / commenter — there is no view-only level for projects, so 'commenter' is the least access possible. A portfolio can be admin / editor / viewer.

Inputs: member_gid (required), parent_gid (required), access_level (required).

member_listList members of a project or portfolioB

Who currently has access, and at what level.

Inputs: parent_gid (required).

portfolio_add_itemAdd project to portfolioA

Add a project (or sub-portfolio) to a portfolio, optionally at a chosen position. Adding an item that is already present moves it to that position.

Inputs: item_gid (required), portfolio_gid (required), insert_after, insert_before.

portfolio_createCreate portfolioC

Create a portfolio in a workspace.

Inputs: name (required), workspace_gid (required), color, public.

portfolio_list_itemsList portfolio itemsC

The projects/portfolios inside a portfolio, in their current display order.

Inputs: portfolio_gid (required).

portfolio_remove_itemRemove item from portfolioA

Remove a project from a portfolio. This also drops any portfolio-level custom field values set on that project.

Inputs: confirm (required), item_gid (required), portfolio_gid (required).

portfolio_updateRename / update portfolioA

Change a portfolio's name, color, or visibility. Only the fields you pass are touched.

Inputs: portfolio_gid (required), name, color, public.

project_createCreate projectB

Create a project in a workspace (team_gid is required in an organization).

Inputs: name (required), workspace_gid (required), color, notes, +3 more.

project_duplicateDuplicate projectA

Copy a project. Tasks, project views (List/Board/Dashboard tabs) and rules are always carried over — this is the only way to give a new project a preconfigured Dashboard, since Asana exposes no dashboard/chart API. Returns a job; duplication finishes asynchronously.

Inputs: name (required), project_gid (required), include, team_gid.

project_list_sectionsList project sectionsB

Sections of a project in display order — the gids needed by section_reorder.

Inputs: project_gid (required).

project_updateRename / update projectC

Change a project's name, notes, color, default view, or archived state.

Inputs: project_gid (required), name, color, notes, +3 more.

section_createCreate sectionB

Add a section to a project, optionally at a chosen position.

Inputs: name (required), project_gid (required), insert_after, insert_before.

section_reorderReorder sectionC

Move an existing section to a new position within its project.

Inputs: project_gid (required), section_gid (required), after_section, before_section.

section_updateRename sectionA

Rename an existing section.

Inputs: name (required), section_gid (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.4/5.0

    Scored across 23 tools

    Disambiguation5/5

    Each tool targets a distinct resource and action: user info, members, projects, portfolios, custom fields, sections, and search. There is no overlap in purpose, and descriptions clearly differentiate them.

    Naming Consistency4/5

    Most tools follow a consistent 'resource_verb' pattern (e.g., portfolio_create, custom_field_attach, section_reorder), but a few use a generic 'asana_' prefix (asana_whoami, asana_find) and 'project_list_sections' mixes resource prefixes, creating minor inconsistency.

    Tool Count4/5

    With 23 tools, the server is slightly on the higher side but still well-scoped for Asana administration. Each tool serves a clear purpose, and the count is justified by the breadth of admin operations covered.

    Completeness3/5

    The tool set covers core admin operations like project/portfolio/folder/section CRUD, custom field management, and member access. However, it lacks delete operations for projects, portfolios, and members, and is missing a general listing tool for projects/portfolios, which are notable gaps for an admin surface.

    Maintenance

    ActivitySlowing
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      An MCP server that uses AI to generate structured Asana project plans from diverse sources like text, PDFs, and meeting transcripts. It enables users to preview, generate, and directly sync detailed task lists, subtasks, and dependencies into Asana.
      1
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      High-performance MCP server that transforms how AI assistants interact with Asana, enabling complex task hierarchies and batch operations for efficient project management.
      6 npm
      3
      MIT