Getting Started

Installation

Get Kyew connected to Claude or ChatGPT in under 60 seconds.


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, you'll have access to all 60+ Kyew tools.

Verify Connection

claude mcp list

You should see:

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

Test It Out

claude "use the remember tool to store that I successfully 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 60+ 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
  • MCP Client: Any MCP-compatible client:
    • Claude Code CLI v1.0.0+
    • Claude Desktop (latest)
    • ChatGPT (via OpenAI Apps SDK)
    • Other MCP clients
  • 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