Use TeamYou with your AI via MCP

MCP is a way for AI to connect to apps.

Connect TeamYou to Claude, Cursor, ChatGPT, OpenClaw, Muse, and other AI apps and agents.

Your AI can read or manage your topics, tasks, projects, and agent drive documents based on the access you choose:

  • Full access: Read and update
  • Read only: View without making changes

Sharing stays off until you enable agent sharing in Settings. You can disconnect anytime, and your AI only receives tools allowed by its permissions.

Which AI do you use?

Not every AI connects over MCP. Grok Bot, for example, works with the TeamYou skill instead: see Agents.

Set up in one minute

Server URL (Full access)

https://www.teamyou.com/mcp

Server URL (Read only)

https://www.teamyou.com/mcp/readonly

Chat apps (Claude, ChatGPT): add it as a custom connector, paste the URL, sign in.

Using a coding agent? Run the installer.

Always-on agents

OpenClaw open-source agent: hosted, or bring your own

Sign in with your browser

Hosted by TeamYou

  1. Connected when we set it up for you. Nothing to do.

or

Bring your own

  1. Run the two commands below.
  2. Approve in the browser when it opens.
Access for OpenClaw

Your AI can read and update your TeamYou.

Copy (Full access)

Run in your terminal

openclaw mcp add teamyou --url https://www.teamyou.com/mcp --transport streamable-http --auth oauth
openclaw mcp login teamyou

Chat apps

Claude chat and Cowork app: claude.ai, desktop, mobile

Sign in with your browser
  1. Open Settings > Connectors and choose Add custom connector.
  2. Paste the URL below.
  3. Click Connect, sign in, approve.

Using the Code tab in the desktop app? That is Claude Code, see its card.

Access for Claude

Your AI can read and update your TeamYou.

Copy (Full access)

Server URL

https://www.teamyou.com/mcp

ChatGPT chat app: web, desktop, mobile

Sign in with your browser
  1. Turn on Settings > Apps & Connectors > Advanced > Developer mode.
  2. Create a connector and paste the URL below.
  3. Sign in and approve.

Needs a Plus, Pro or Business plan.

Access for ChatGPT

Your AI can read and update your TeamYou.

Copy (Full access)

Server URL

https://www.teamyou.com/mcp

Ask your AI

Paste this into Claude, ChatGPT, Cursor or any AI.

Connect me to TeamYou's MCP server at https://www.teamyou.com/mcp, or the read-only server at https://www.teamyou.com/mcp/readonly if I should only read. If you are a chat app, walk me through adding it as a custom connector and signing in. If you are a coding agent with a shell, run the installer at https://www.teamyou.com/mcp/install.sh (PowerShell: https://www.teamyou.com/mcp/install.ps1) and tell me what it changed. Setup details: https://www.teamyou.com/mcp/install.

Coding agents

Claude Code coding agent: desktop, VS Code, terminal

Sign in with your browser

Desktop app

  1. Click + next to the prompt box, then Connectors, then Add custom connector.
  2. Paste the URL below and click Add.
  3. Sign in when it asks.

Connectors are shared with Chat and Cowork, so if you already added TeamYou there, it is done.

or

VS Code

  1. Type /mcp in the chat panel.
  2. Choose Add server, name it teamyou and paste the URL below.
  3. Accept, then sign in when it asks.

Needs Claude Code 2.1.261 or later.

or

Terminal

  1. Run the command below.
  2. Run /mcp inside Claude Code and choose Authenticate to sign in.

Chat and Cowork use connectors instead, see the Claude card.

Access for Claude Code

Your AI can read and update your TeamYou.

Copy (Full access)

Server URL

https://www.teamyou.com/mcp

Run in your terminal

claude mcp add --transport http teamyou https://www.teamyou.com/mcp --scope user

Codex coding agent: desktop, VS Code, terminal

Sign in with your browser

Desktop app

  1. Settings, MCP servers, Add server.
  2. Choose Streamable HTTP, paste the URL below.

or

Terminal

  1. Run the two commands below.
Access for Codex

Your AI can read and update your TeamYou.

Copy (Full access)

Server URL

https://www.teamyou.com/mcp

Run in your terminal

codex mcp add teamyou --url https://www.teamyou.com/mcp
codex mcp login teamyou

Muse Code coding agent from Meta: terminal

Sign in with your browser

Terminal

  1. Add the block below to your Muse settings file.
  2. Run muse mcp login teamyou and approve in the browser.

The installer does not edit this file. Paste the block into the file shown.

Access for Muse Code

Your AI can read and update your TeamYou.

Copy (Full access)

~/.config/muse/settings.json

{
  "schema_version": 1,
  "mcp_servers": {
    "teamyou": {
      "transport": "streamable_http",
      "url": "https://www.teamyou.com/mcp",
      "mode": "optional"
    }
  }
}

Run in your terminal

muse mcp login teamyou

Code editors

Cursor code editor

One click

Install (Full access)

Add to Cursor
  1. Click Add to Cursor, or paste the config below into ~/.cursor/mcp.json.
  2. Reload the Cursor window. Settings > MCP lists the server.
Access for Cursor

Your AI can read and update your TeamYou.

Copy (Full access)

~/.cursor/mcp.json

{
  "mcpServers": {
    "teamyou": {
      "url": "https://www.teamyou.com/mcp"
    }
  }
}

VS Code code editor, with Copilot

One click

Install (Full access)

Install in VS Code
  1. Click Install in VS Code.
  2. VS Code opens and asks you to confirm the server. Sign in when it prompts you.
Access for VS Code

Your AI can read and update your TeamYou.

Copy (Full access)

Or connect every coding agent at once

One command finds the agents and AI apps installed on your machine and connects them all.

  • Needs Node 18 or newer.
  • Touches only the TeamYou entry in each config, and keeps a .ty-bak backup of every file it changes.
  • Run it again any time. Nothing changes.
  • Add --dry-run to see the summary without writing anything.
  • Add --readonly to connect the read-only server instead.
Access for the installer

Your AI can read and update your TeamYou.

Copy (Full access)

Terminal (macOS, Linux)

curl -fsSL https://www.teamyou.com/mcp/install.sh | sh

PowerShell (Windows)

irm https://www.teamyou.com/mcp/install.ps1 | iex
More

Windsurf code editor

Needs an API key
  1. Create an API key first, then paste. Set TEAMYOU_API_KEY in your environment, or put the key in the file yourself.
  2. Paste the config below into ~/.codeium/windsurf/mcp_config.json.
  3. Click Refresh in Windsurf's MCP panel.

For the current Devin-based Windsurf, add the server from its MCP panel instead.

Access for Windsurf

Your AI can read and update your TeamYou.

Copy (Full access)

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "teamyou": {
      "serverUrl": "https://www.teamyou.com/mcp",
      "headers": {
        "Authorization": "Bearer ${env:TEAMYOU_API_KEY}"
      }
    }
  }
}

Zed code editor

Needs an API key
  1. Create an API key first, then paste. Set TEAMYOU_API_KEY in your environment, or put the key in the file yourself.
  2. Paste the config below into ~/.config/zed/settings.json.
  3. Save the file. Zed picks up settings.json as soon as you do.

The installer does not edit this file. Paste the block into the file shown.

Access for Zed

Your AI can read and update your TeamYou.

Copy (Full access)

~/.config/zed/settings.json

{
  "context_servers": {
    "teamyou": {
      "source": "custom",
      "url": "https://www.teamyou.com/mcp",
      "headers": {
        "Authorization": "Bearer ${env:TEAMYOU_API_KEY}"
      }
    }
  }
}

Cline VS Code extension

Needs an API key
  1. Create an API key first, then paste. Set TEAMYOU_API_KEY in your environment, or put the key in the file yourself.
  2. Paste the config below into ~/.cline/data/settings/cline_mcp_settings.json.
  3. Open the file from Cline: MCP Servers > Configure MCP Servers. The Cline CLI reads ~/.cline/mcp.json instead.

The installer does not edit this file. Paste the block into the file shown.

Access for Cline

Your AI can read and update your TeamYou.

Copy (Full access)

~/.cline/data/settings/cline_mcp_settings.json

{
  "mcpServers": {
    "teamyou": {
      "type": "streamableHttp",
      "url": "https://www.teamyou.com/mcp",
      "headers": {
        "Authorization": "Bearer ${env:TEAMYOU_API_KEY}"
      }
    }
  }
}

Gemini CLI terminal agent

Needs an API key
  1. Create an API key first, then paste. Set TEAMYOU_API_KEY in your environment, or put the key in the file yourself.
  2. Paste the config below into ~/.gemini/settings.json.
  3. Run /mcp list in Gemini CLI to confirm.
Access for Gemini CLI

Your AI can read and update your TeamYou.

Copy (Full access)

~/.gemini/settings.json

{
  "mcpServers": {
    "teamyou": {
      "httpUrl": "https://www.teamyou.com/mcp",
      "headers": {
        "Authorization": "Bearer ${env:TEAMYOU_API_KEY}"
      }
    }
  }
}

Goose desktop agent

One click

Install (Full access)

Add to Goose
  1. Click Add to Goose.
  2. Goose opens and asks you to add the extension. Sign in when it prompts you.
Access for Goose

Your AI can read and update your TeamYou.

Copy (Full access)

Hermes terminal agent

Needs an API key
  1. Create an API key first, then paste. Set TEAMYOU_API_KEY in your environment, or put the key in the file yourself.
  2. Paste the config below into ~/.hermes/config.yaml.
  3. Run /reload-mcp in Hermes.

The installer does not edit this file. Paste the block into the file shown.

Access for Hermes

Your AI can read and update your TeamYou.

Copy (Full access)

~/.hermes/config.yaml

mcp_servers:
  teamyou:
    url: "https://www.teamyou.com/mcp"
    headers:
      Authorization: "Bearer ${env:TEAMYOU_API_KEY}"

For developers

Server URL

https://www.teamyou.com/mcp

Read-only server URL

https://www.teamyou.com/mcp/readonly

The read-only server offers only the reading tools, asks for read access alone at sign-in, and lets no key change anything.

Your AI gets 8 tools by default. Add ?tools=extended to the URL for all 10.

  • agent_drive_read
  • agent_drive_write
  • knowledge_read
  • knowledge_write
  • search
  • sharing
  • work_read
  • work_write

Team tools use the agent:write permission, which is available on API keys only.

Streamable HTTP, same scopes and handlers as the REST API.

Claude desktop app: chat and Cowork use connectors (see the Claude card); the mcp-remote bridge config is available for the desktop app's file route if you need it.

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "teamyou": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://www.teamyou.com/mcp"
      ]
    }
  }
}

OpenClaw: the config-file form of the same entry, with browser sign-in. A provisioned toolFilter must name the pillar tools, for example agent_drive_write, knowledge_write, work_write.

~/.openclaw/openclaw.json

{
  "mcp": {
    "servers": {
      "teamyou": {
        "url": "https://www.teamyou.com/mcp",
        "transport": "streamable-http",
        "auth": "oauth"
      }
    }
  }
}

Permissions

Sign in with your browser and your AI gets the permissions below.

Automation is only available on an API key.

  • Read everything

    View topics, details, projects, areas, tasks, Agent Drive documents, and settings.

  • Write knowledge

    Create, edit, and delete topics, details, and connections.

  • Write Agent Drive

    Create, update, and delete the agent's Agent Drive documents.

  • Write work items

    Create, update, complete, and delete projects, areas, and tasks.

  • Manage automation
    Needs an API key

    Configure heartbeat and scheduled actions, and send instructions to other agents.

  • Share on your behalf
    Off by default

    Control who can open what you share: keep it private, share it by link, or open it to anyone signed in. Blocked for agents until you allow agent sharing in Settings.

Create an API key