# Connect

> Add TasksMate to Claude, Claude Code, Cursor, VS Code and other MCP clients — one URL, sign in with OAuth.

**What this is:** adding TasksMate to your AI client. **When you need it:** once per client — after that the client stays signed in.

**Server URL — the same for every organization**

```text
{{MCP_URL}}
```

finalised at 5.1: The URL.

## Sign in

1.  **Authorize** — the client sends you to TasksMate. Sign in and choose the organization.
2.  **Consent** — TasksMate names the client and lists the scopes it asks for. You approve once per client.
3.  **Done** — the client holds a token and refreshes it itself. Nothing to paste.

Connect once: sign in, approve the scopes, done

finalised at 5.2: One universal URL with the organization chosen after sign-in, and the consent screen.

## Your client

**Claude**


In `Settings → Connectors → Add custom connector`:

```text
Name: TasksMate
URL:  {{MCP_URL}}
```

**Sign in:** You are sent to TasksMate to sign in.

**Claude Code**


Run in a terminal:

```bash
claude mcp add --transport http tasksmate "{{MCP_URL}}"
```

**Sign in:** Run /mcp in Claude Code, then choose tasksmate.

**Claude Desktop**


In `Settings → Connectors → Add custom connector`:

```text
Name: TasksMate
URL:  {{MCP_URL}}
```

**Sign in:** You are sent to TasksMate to sign in.

**Cursor**


Add to `.cursor/mcp.json`:

**.cursor/mcp.json**

```json
{
  "mcpServers": {
    "tasksmate": {
      "url": "{{MCP_URL}}"
    }
  }
}
```

**Sign in:** Prompted on first use.

**VS Code**


Add to `.vscode/mcp.json`:

**.vscode/mcp.json**

```json
{
  "servers": {
    "tasksmate": {
      "type": "http",
      "url": "{{MCP_URL}}"
    }
  }
}
```

**Sign in:** Prompted when the server starts.

**GitHub Copilot**


Add to `.vscode/mcp.json (Copilot Chat, agent mode)`:

**.vscode/mcp.json (Copilot Chat, agent mode)**

```json
{
  "servers": {
    "tasksmate": {
      "type": "http",
      "url": "{{MCP_URL}}"
    }
  }
}
```

**Sign in:** Prompted when the server starts.

**Codex**


Run in a terminal:

```bash
codex mcp add tasksmate --url "{{MCP_URL}}"
codex mcp login tasksmate
```

**Sign in:** The second line opens the sign-in.

**Gemini CLI**


Run in a terminal:

```bash
gemini mcp add --transport http tasksmate "{{MCP_URL}}"
```

**Sign in:** Run /mcp auth tasksmate in Gemini CLI.

**Windsurf**


Add to `~/.codeium/windsurf/mcp_config.json`:

**~/.codeium/windsurf/mcp\_config.json**

```json
{
  "mcpServers": {
    "tasksmate": {
      "serverUrl": "{{MCP_URL}}"
    }
  }
}
```

**Sign in:** Prompted when the server starts.

**Zed**


Add to `Zed settings.json`:

**Zed settings.json**

```json
{
  "context_servers": {
    "tasksmate": {
      "url": "{{MCP_URL}}"
    }
  }
}
```

**Sign in:** Prompted when the server starts.

finalised at 5.3: Each artefact — rows of the in-app generator’s CLIENTS table, each tested on its client.

## Local (stdio) instead

For a client that starts a local process instead of calling a URL. The package signs in with an access token from [Developers → Tokens](https://tasksmate.indrasol.com/developers?dev=tokens), scoped to what the client may do.

**npx**


```json
{
  "mcpServers": {
    "tasksmate": {
      "command": "npx",
      "args": [
        "-y",
        "@tasksmate/mcp"
      ],
      "env": {
        "{{TOKEN_ENV}}": "tm_live_…"
      }
    }
  }
}
```

**uvx**


```json
{
  "mcpServers": {
    "tasksmate": {
      "command": "uvx",
      "args": [
        "tasksmate-mcp"
      ],
      "env": {
        "{{TOKEN_ENV}}": "tm_live_…"
      }
    }
  }
}
```

Both packages are pre-release (`0.x`) until the API declares v1.

finalised at 5.3: The variable the packages read the token from, `{{TOKEN_ENV}}`.

## Generate it in the app

[Developers](https://tasksmate.indrasol.com/developers) → **MCP** writes the artefact for your client, with a **Read-only** switch and the **tool groups** it may use (tasks, projects, teams, views, comments, admin — admin off by default). The server enforces both. **Copy prompt** copies a setup instruction for your agent.

finalised at 5.3: The generator and its link.

## Don’t see your client?

Any client that supports remote MCP servers (Streamable HTTP, OAuth) works with the URL; any other, with a stdio package.

---
Source: https://developers.tasksmate.indrasol.com/mcp/connect/