Asana Integration

Connect Asana to Brief to understand your work pipeline and team velocity.

Last updated: November 25, 2025

Asana gives Brief understanding of your work pipeline and velocity. For teams using Asana, it's the primary source for understanding what you're building and how fast you ship.

What data does Brief extract from Asana?

  • Tasks and Projects — What's backlogged, in progress, and completed
  • Sections and Milestones — How you organize and track work
  • Velocity Metrics — Completion patterns, cycle time, throughput
  • Custom Fields — Priority, status, and other metadata

Why should I connect Asana to Brief?

Work Pipeline

See what's being built right now vs. what's planned vs. what shipped.

Velocity Understanding

Brief calculates how fast your team ships based on task completion patterns.

MCP Write Access

When using Brief via MCP, your AI can create and update Asana tasks directly from your IDE.

How do I set up the Asana integration?

Setup time: 30 seconds
Initial sync: 1-2 minutes
Updates: Real-time via webhooks

Steps

  1. Go to Integrations in Brief
  2. Find Asana and click Connect
  3. Authorize Brief in Asana's OAuth flow
  4. Select workspace — Choose which Asana workspace to connect
  5. Done! Brief starts syncing
Brief needs read access to tasks and projects. This is granted automatically during OAuth.

What Happens Next

After connecting:

  1. Initial sync — Brief fetches recent tasks and projects (1-2 minutes)
  2. Velocity analysis — Velocity agent calculates metrics
  3. Webhook registration — Brief subscribes to task updates
  4. Continuous sync — Updates automatically as tasks change

Common Issues

Why does it say "Workspace access denied"?

Brief doesn't have permission to access the Asana workspace. Disconnect and reconnect, ensuring you select the correct workspace during OAuth.

Why aren't any tasks syncing?

Your Asana workspace may be empty or Brief may lack permissions. Check that Brief has read access to projects in Asana workspace settings.

Why aren't tasks updating?

This could be webhook delivery issues or Asana API rate limits. Wait 5 minutes for retry. If issues persist, disconnect and reconnect.

Why does the connection show 'Disconnected'?

Your OAuth token expired or was revoked. Click Reconnect in Brief integrations page to reauthorize.

How long does setup take?

Initial setup takes about 30 seconds for the OAuth flow. The initial sync takes 1-2 minutes to fetch your tasks and projects. Updates happen in real-time via webhooks.

Can Brief create and update Asana tasks?

Yes, when using Brief via MCP (Model Context Protocol), your AI can create and update Asana tasks directly from your IDE with write permissions.

What permissions does Brief need?

Brief needs read access to extract context. For MCP write features, Brief also needs write access. Permissions are granted during OAuth.

What's Next?

Now that Asana is connected: