How to use with Claude
Connect Claude Code to your Awaken account through the remote MCP server.
Before you begin
API access is currently in beta and requires a Dolphin or Whale plan. If the API Keys page says access is not enabled for your client, email beta@awaken.tax to request it.
For a visual walkthrough, watch Connecting Awaken to Claude or Codex with MCP.
In Awaken, open Settings → API Keys. The page shows your client ID and a copy-ready command for Claude.
Create an API key
Do not commit the key or paste it into chat. If it is exposed, expired, or no longer needed, revoke it from Settings → API Keys and create a replacement.
1. Open API Keys
In the Awaken workspace you want to connect, open Settings → API Keys and select Create API Key.
2. Choose access
Give the key a recognizable name, choose Read for analysis or Read + Write only when the assistant should edit data, and optionally set an expiration.
3. Copy the secret and client ID
Copy the awaken_… secret when it appears; for security, it cannot be viewed again. Also copy the client ID shown on the API Keys page. The key is scoped to that client only.
Connect Claude Code
Replace YOUR_API_KEY and YOUR_CLIENT_ID with the values from the API Keys page, then run the command in your terminal.
export AWAKEN_API_KEY="YOUR_API_KEY"claude mcp add awaken https://mcp.awaken.tax/mcp \--transport http \--scope project \-H "Authorization: Bearer $AWAKEN_API_KEY" \-H "x-client-id: YOUR_CLIENT_ID"
Verify the connection
Run claude mcp list to confirm that the awaken server is configured. Then start a new Claude Code session and ask it to use Awaken.
Review
Show my largest taxable events this year and flag anything missing cost basis.
Clean up
Find my unreviewed transactions, explain the likely labels, and ask before changing anything.
Reports
Generate my Form 8949 report for 2025 and tell me when it is ready.