# Awaken Tax MCP server

> Connects AI clients to your Awaken crypto tax workspace to review transactions, investigate cost basis, and generate tax reports.

- Repository: https://github.com/awakentax/plugin
- Page: https://hostedmcp.org/servers/awakentax/plugin
- Transport: remote
- Stars: 0
- License: MIT
- Latest version: 1.0.0

## Install

### Claude Code

```sh
claude mcp add --transport http plugin https://mcp.awaken.tax/mcp
```

### Cursor (`~/.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "plugin": {
      "url": "https://mcp.awaken.tax/mcp"
    }
  }
}
```

### VS Code (`.vscode/mcp.json`)

```json
{
  "servers": {
    "plugin": {
      "type": "http",
      "url": "https://mcp.awaken.tax/mcp"
    }
  }
}
```

### Codex (`~/.codex/config.toml`)

```toml
[mcp_servers.plugin]
url = "https://mcp.awaken.tax/mcp"
```

### Gemini CLI (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "plugin": {
      "httpUrl": "https://mcp.awaken.tax/mcp"
    }
  }
}
```

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `CLIENT_ID` | no | no |  |

## FAQ

### How do I connect Awaken to Cursor?

Install the Awaken plugin from Cursor's Customize page, enable the awaken MCP server, and complete the OAuth authentication flow in your browser.

### Can I use the MCP connection with read-only access?

Yes, during the OAuth consent process, you can choose to approve only read access instead of read and write access.

### Do I need to run a local server to use this MCP connection?

No, the plugin uses a hosted MCP connection, so no local server or runtime is required.

### How does the Gemini CLI connect to Awaken?

The Gemini CLI uses a portfolio ID and an API key joined by a colon, which can be found in your Awaken settings.