Terminal
Terminal/Skill
Walks through creating an Asana OAuth app and saving its client ID and secret as environment variables for Asana MCP.
By Asana
Works with
npx skills add asana/cursor-marketplace-plugin --skill asana-setupThis skill ensures the Asana MCP server is correctly authenticated before any Asana tools are used.
The Asana MCP connection requires two credentials from a registered Asana OAuth app:
ASANA_CLIENT_IDASANA_CLIENT_SECRETThese must be set as environment variables in the user's shell profile.
Run this skill automatically if:
Check whether ASANA_CLIENT_ID and ASANA_CLIENT_SECRET are set in the user's environment. You can do this by running:
echo $ASANA_CLIENT_ID
echo $ASANA_CLIENT_SECRET
If both return non-empty values, skip to Step 4.
If credentials are missing, tell the user:
To connect Cursor to Asana, you need to register an OAuth app in Asana's developer console. Here's how:
- Go to https://app.asana.com/0/my-apps
- Click Create new app and select "MCP App" as the app type
- Give it a name (e.g. "Cursor MCP")
- Under OAuth, add this redirect URI:
cursor://anysphere.cursor-mcp/oauth/callback- Copy your Client ID and Client Secret
Once the user has their credentials, instruct them to add these lines to their shell profile:
For zsh (macOS default) — add to ~/.zshrc:
export ASANA_CLIENT_ID="your_client_id_here"
export ASANA_CLIENT_SECRET="your_client_secret_here"
For bash — add to ~/.bashrc or ~/.bash_profile:
export ASANA_CLIENT_ID="your_client_id_here"
export ASANA_CLIENT_SECRET="your_client_secret_here"
For Windows (WSL) — add to ~/.bashrc:
export ASANA_CLIENT_ID="your_client_id_here"
export ASANA_CLIENT_SECRET="your_client_secret_here"
After saving, tell the user to run:
source ~/.zshrc # or ~/.bashrc depending on their shell
Then restart Cursor.
After credentials are set, confirm the MCP server is reachable by attempting to call an Asana tool (e.g. list workspaces). If it succeeds, confirm to the user that setup is complete.
If it fails, ask the user to verify:
cursor://anysphere.cursor-mcp/oauth/callback is registered in their Asana app