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.

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

Portfolio

Custom Field / Dropdown

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

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.