Getting Started

Installation

Connect Kyew to your AI app in under 60 seconds. Once connected, your AI gains persistent memory, custom tools, and access to your services.


The fastest way to get started is with Claude Code CLI:

claude mcp add kyew --transport http --scope user https://mcp.kyew.ai/mcp

When prompted, click the authentication link to sign in with Google. Once authenticated, your AI will have access to all Kyew capabilities — memory, tools, and service connections.

Verify Connection

claude mcp list

You should see:

kyew: https://mcp.kyew.ai/mcp (HTTP) - ✓ Connected

Test It Out

claude "remember that I just connected to Kyew"

ChatGPT

Kyew works with ChatGPT through the OpenAI Apps SDK.

Setup

  1. Go to ChatGPT and open your app/GPT configuration
  2. Add an MCP server with URL: https://mcp.kyew.ai/mcp
  3. When prompted, sign in with Google

Verify

Ask ChatGPT:

What Kyew tools are available?

You should see all available tools. Your data syncs across both Claude and ChatGPT when using the same Google account.


Claude Desktop

For Claude Desktop, add the following to your MCP configuration file:

macOS

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

{
  "mcpServers": {
    "kyew": {
      "command": "npx",
      "args": ["-y", "@anthropic-ai/mcp-remote-http", "https://mcp.kyew.ai/mcp"]
    }
  }
}

Windows

Edit %APPDATA%\Claude\claude_desktop_config.json:

{
  "mcpServers": {
    "kyew": {
      "command": "npx",
      "args": ["-y", "@anthropic-ai/mcp-remote-http", "https://mcp.kyew.ai/mcp"]
    }
  }
}

After saving, restart Claude Desktop. You'll be prompted to authenticate with Google on first use.


Authentication

Kyew uses Google OAuth for authentication. When you first connect:

  1. A browser window opens with the Google sign-in page
  2. Sign in with your Google account
  3. Grant access to Kyew
  4. You're redirected back to your client with access granted

User-Scoped Data

All your data is private to your Google account:

Your Google Account → userId: google:1234567890
  ├─ Memories: Private, encrypted
  ├─ Skills: Private, encrypted
  ├─ Tools: Private, encrypted
  └─ Connections: Private, encrypted

Other users cannot access your data. Each Google account gets completely isolated storage.

Cross-Device and Cross-Client Sync

Same Google account = same data everywhere:

Claude Desktop:  Sign in with you@gmail.com → All data available
Claude Code:     Sign in with you@gmail.com → Same data synced
ChatGPT:         Sign in with you@gmail.com → Same data synced

Requirements

  • Google Account: Required for authentication
  • AI App: Any app that supports MCP:
    • Claude Code CLI v1.0.0+
    • Claude Desktop (latest)
    • ChatGPT (via OpenAI Apps SDK)
    • Other MCP-compatible apps
  • Node.js: v18 or later (for Claude Desktop setup only)

Troubleshooting

"Authentication failed"

  1. Check that you're using a valid Google account
  2. Try clearing your browser cookies and re-authenticating
  3. Ensure popups are not blocked for the OAuth flow

"Connection refused"

  1. Check your internet connection
  2. Verify the server status at mcp.kyew.ai/health
  3. Try disconnecting and reconnecting: claude mcp remove kyew && claude mcp add kyew --transport http --scope user https://mcp.kyew.ai/mcp

"Tools not showing up"

  1. Restart your MCP client
  2. Verify authentication completed successfully
  3. For Claude Code: check with claude mcp list

Next Steps

Once connected, try these to get started:

  1. Store your first memory: Ask your AI to remember something about your project
  2. Explore the tools: Ask "what Kyew tools are available?"
  3. Read the Quick Start guide: Learn the core workflow
Previous
Introduction