Skip to main content
Glama

asana-admin-mcp

MCP-Server für Asana-Strukturierung — Portfolio, Custom Field / Dropdown, Projekt, Sektion Füllt die Lücken, die der Standard-Asana-Connector nicht kann (der konzentriert sich auf Aufgaben/Lesen)


⚠️ Dashboard funktioniert nicht — und das ist keine Einschränkung dieses MCP

Asana bietet keine öffentliche API für Dashboard / Chart / Widget / Project-View-Tabs. (Alle 175 Endpoints der offiziellen OpenAPI-Spezifikation durchgesehen — kein einziger davon.)

Der einzige Weg, das zu automatisieren, ist project_duplicate — laut Spezifikation werden beim Duplizieren eines Projekts die Project Views (Tabs Liste / Board / Dashboard) immer mitkopiert und können nicht abgeschaltet werden. → Lege ein Dashboard in einem „Masterprojekt“ an und dupliziere es bei jedem gewünschten neuen Projekt.

🟡 Noch nicht bewiesen: Die Spezifikation sagt, dass „Project Views“ mitgehen, aber nicht eindeutig, ob die im Dashboard eingerichteten Charts ebenfalls mitgehen oder nur leere Tabs — per API nicht prüfbar (kein Endpoint zum Lesen eines Charts), daher visuell prüfen. Der Smoke-Test vom 17.08.2026 hat ein Projekt ohne Chart dupliziert und beantwortet diese Frage daher noch nicht.

Hinweis: Project Templates übertragen das Dashboard nicht (immer noch ein offener Feature-Request im Asana-Forum). Also Duplikat verwenden, nicht Template.


Related MCP server: asana-mcp

Installation

1. Zuerst Asana-Token besorgen (jeder braucht sein eigenes)

Folge GET-TOKEN.md → speichere es unter ~/.asana_token

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

Das Token ist an die Rechte der Person gebunden. Niemals das Token anderer verwenden — im Asana-Log wird der Name des Token-Inhabers angezeigt.

2. Plugin installieren (empfohlen)

In Claude Code zwei Zeilen eingeben:

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

Claude Code klont das Repo + führt npm ci selbst aus und registriert den MCP — ~/.claude.json muss nicht angefasst werden. Später aktualisieren mit /plugin update

Erforderlich ist Node 20+ auf dem Rechner (node -v prüfen)

Methode 2 — manuelle Installation (falls kein Plugin verwendet werden soll)

Repo klonen und ติดตั้ง-asana-admin-mcp.command doppelklicken. Das Skript fragt nach dem Token, führt npm install aus und schreibt ~/.claude.json (mit Backup bei jedem Lauf).

Nicht beide Methoden gleichzeitig verwenden — sonst gibt es zwei MCPs mit dem Namen asana-admin.

Das Token wird zuerst aus der Umgebungsvariable ASANA_TOKEN gelesen, wenn nicht vorhanden Fallback auf ~/.asana_token. → Das Token ist nie im Repo und muss nicht in ~/.claude.json stehen.


Tools (21)

Jedes Tool akzeptiert gid, nicht den Namen — mit asana_find den Namen in gid umwandeln.

Discovery

Tool

Beschreibung

asana_whoami

Eigene Identität + alle Workspaces (hier beginnen, denn fast jedes Create benötigt workspace_gid)

asana_find

Typeahead-Suche nach gid anhand des Namens — project / portfolio / custom_field / task / team / user / tag / goal

asana_list_custom_fields

Custom Fields im Workspace oder an Projekt/Portfolio gebunden — liefert enum_options inkl. gid, die Eingabe für alle Dropdown-Tools sind

Portfolio

Tool

Beschreibung

portfolio_create

Portfolio erstellen

portfolio_update

Umbenennen / Farbe ändern / public

portfolio_list_items

Projekte im Portfolio in tatsächlicher Anzeige-Reihenfolge anzeigen

portfolio_add_item

Projekt zum Portfolio hinzufügen + Position angeben (insert_before / insert_after) — erneuter Aufruf mit vorhandenem Element = Position verschieben

portfolio_remove_item

Projekt entfernen (erfordert confirm: true)

Custom Field / Dropdown

Tool

Beschreibung

custom_field_create

Feld erstellen — enum (Dropdown mit Einzelauswahl) / multi_enum / text / number / date / people

custom_field_update

Umbenennen / Beschreibung bearbeiten

enum_option_create

Wert zum Dropdown hinzufügen + Position angeben

enum_option_update

Umbenennen / Farbe ändern / enabled:false zum Deaktivieren

enum_option_reorder

Reihenfolge der Dropdown-Werte festlegen

custom_field_attach

Feld an Projekt oder Portfolio binden (is_important:true = als Spalte anzeigen)

Asana kann Dropdown-Werte nicht löschen — nur enabled:false ist möglich; Aufgaben, bei denen dieser Wert bereits ausgewählt war, behalten den ursprünglichen Wert.

Project / Section

Tool

Beschreibung

project_create

Projekt erstellen (in einer Organisation ist team_gid erforderlich)

project_update

Umbenennen / Notizen / Farbe / default_view / Archivieren

project_duplicate

Projekt duplizieren inkl. Dashboard — einzige Lösung fürs Dashboard (gibt einen Job zurück, läuft asynchron)

project_list_sections

Sektionen in Reihenfolge + gid

section_create

Sektion hinzufügen + Position angeben

section_update

Sektion umbenennen

section_reorder

Sektionen sortieren

Es gibt kein Tool zum absichtlichen Löschen von Projekt / Portfolio / Custom Field — diese können nicht wiederhergestellt werden, daher in der Weboberfläche löschen.


Farben (gültig für Portfolio / Projekt / Enum-Option)

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


Test

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

Erstellt echte Objekte im ersten Workspace des Tokens, deren Name mit ZZ-mcp-smoke-* beginnt → prüft jedes Tool → löscht sie danach selbst alle. Ohne Token wird nur der erste Teil ausgeführt (Serverstart + Tools auflisten).


Hinweise zur Arbeitsweise

  • 429 → automatischer Retry 3 Mal gemäß Retry-After

  • Fehler von Asana werden als echte API-Meldung zurückgegeben (zeigt an, welches Feld fehlt / welche gid falsch ist), nicht nur als Statuscode

  • Nicht gesendete Felder werden nicht angefasst — portfolio_update mit nur name löscht die Farbe nicht.

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
    ResponsivenessNo recent community issues

    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