MCP Server

Active

Kody MCP Server

io.github.kentcdodds/kody

Personal assistant MCP server with search, execute, packages, jobs, secrets, and integrations—portable across MCP hosts.

Repository Registry

What is the Kody MCP server?

Kody is a personal assistant MCP server built on Cloudflare Workers that provides memory, keys, code, and automations for AI agents. It offers a compact MCP surface with powerful search and code execution capabilities, multi-user isolation, and portability across any MCP-compatible host. The server ships with a Remix UI, OAuth protection, and support for packages, jobs, secrets, and integrations.

Kody serves as your AI assistant's home base—a centralized platform for storing and managing assistant state including memories, API keys, code packages, scheduled jobs, and secrets. It's designed to be portable across different MCP hosts (like Claude, ChatGPT, and Cursor) while keeping each user's data fully isolated. Built on Cloudflare's serverless infrastructure, it emphasizes a lean MCP interface with powerful search and code execution rather than a large static tool catalog.

How to install Kody

Copy-paste configuration for popular MCP clients.

transport: http

Config generated by PluginBench — verify against the source before use.

Cursor

~/.cursor/mcp.json

{
  "mcpServers": {
    "kody": {
      "url": "https://kody.codes/mcp"
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "kody": {
      "serverUrl": "https://kody.codes/mcp"
    }
  }
}

VS Code

.vscode/mcp.json

{
  "servers": {
    "kody": {
      "type": "http",
      "url": "https://kody.codes/mcp"
    }
  }
}

Claude Desktop

Claude Desktop connects to remote servers via the mcp-remote bridge.

{
  "mcpServers": {
    "kody": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://kody.codes/mcp"
      ]
    }
  }
}

Claude Code

claude mcp add --transport http kody https://kody.codes/mcp

Tools & capabilities

Tools this server exposes to the agent.

search — Search across assistant memories, packages, jobs, and stored data
execute — Code Mode execution for running code and automations
packages — Manage and store code packages for reuse across sessions
jobs — Schedule and manage background jobs and automations
secrets — Securely store and retrieve API keys and sensitive credentials
values — Store and retrieve persistent key-value data

Use cases

Store API keys and secrets securely for use across multiple AI agent hosts
Search through past conversations and stored memories to provide context to your assistant
Execute custom code and automations triggered by your assistant
Manage reusable code packages that your assistant can access across different sessions
Schedule background jobs and recurring tasks for your assistant to perform

Kody MCP server FAQ

What is Kody?

Kody is a personal assistant MCP server that acts as a centralized home for your AI agent's memory, keys, code, and automations. It's built on Cloudflare Workers and designed to work across any MCP-compatible host like Claude, ChatGPT, or Cursor.

Is Kody free to use?

Kody is licensed under the Functional Source License (FSL-1.1-ALv2), which allows free use for non-competing purposes. It becomes Apache 2.0 licensed two years after each version release.

How do I connect Kody to Claude or Cursor?

Kody is available as a remote MCP server at https://kody.codes/mcp. You can configure it in your MCP host by adding this URL as a streamable-http connection.

Do I need to authenticate to use Kody?

Yes, Kody uses OAuth for authentication and provides multi-user isolation. Each signed-in user gets a fully isolated assistant with their own packages, jobs, secrets, and memories.

What data does Kody store?

Kody stores assistant memories, API keys and secrets, code packages, scheduled jobs, persistent key-value data, and session information. All data is user-isolated and stored on Cloudflare's infrastructure.

Can I self-host Kody?

Kody is built on Cloudflare Workers and is designed to run on Cloudflare's platform. The source code is available on GitHub, but self-hosting would require adapting it to your infrastructure.

README (reference)

Source of truth, from the repository.

<div align="center"> <img src="./packages/worker/public/logo.png" alt="kody logo" width="400" /> <p> <strong>Your assistant's home — the memory, keys, code, and automations your AI agent keeps, portable across every MCP host. Built on Cloudflare Workers.</strong> </p> <p> <a href="https://github.com/kentcdodds/kody/actions/workflows/deploy.yml"><img src="https://img.shields.io/github/actions/workflow/status/kentcdodds/kody/deploy.yml?branch=main&style=flat-square&logo=github&label=CI" alt="Build Status" /></a> <img src="https://img.shields.io/badge/TypeScript-6.0-blue?style=flat-square&logo=typescript&logoColor=white" alt="TypeScript" /> <img src="https://img.shields.io/badge/Node-26-5FA04E?style=flat-square&logo=node.js&logoColor=white" alt="Node 26" /> <img src="https://img.shields.io/badge/Cloudflare-Workers-F38020?style=flat-square&logo=cloudflare&logoColor=white" alt="Cloudflare Workers" /> <img src="https://img.shields.io/badge/Remix-3.0_beta-000000?style=flat-square&logo=remix&logoColor=white" alt="Remix" /> </p> </div>

Kody is your assistant's home—the memory, keys, code, and automations your AI agent keeps, portable across every MCP host. Built on Cloudflare Workers and the Model Context Protocol (MCP), it ships a Remix UI, Worker-based request routing, package runtime plumbing, and OAuth-protected MCP endpoints. The project favors a compact MCP surface with powerful search and Code Mode execute flows over a large static tool catalog.

Kody is a multi-user personal assistant: each signed-in user gets a fully isolated assistant (packages, jobs, secrets, values, memories, and related state). Tests and fixtures may seed deterministic local accounts, but no account is privileged at runtime. The repo follows several epicflare starter conventions.

The repo is organized as an Nx monorepo, with shared modules in packages/shared (@kody-internal/shared), the main app worker under packages/worker, and mock Workers under packages/mock-servers/*.

Quick Start

npm install
npm run dev

The dev server runs at localhost:3742 by default (the CLI picks the next free port and prints the resolved URL). Wrangler handles the local Cloudflare Workers runtime and D1 database automatically.

To scaffold a new project from the epicflare template instead, run npx create-epicflare.

See docs/contributing/getting-started.md for the full setup paths and expectations. Contributors and agents should start with AGENTS.md for repo-specific guidance.

If you are trying to understand what this repository is for, start with docs/contributing/project-intent.md.

Tech Stack

Layer	Technology
Runtime	Cloudflare Workers
UI Framework	Remix 3 (beta)
Package Manager	npm
Workspace	Nx + npm workspaces
Database	Cloudflare D1
Session/OAuth	Cloudflare KV
MCP State	Durable Objects
E2E Testing	Playwright
Bundler	esbuild

Scope

Fair Source personal assistant platform, not a general-purpose agent harness
MCP-first architecture intended to work across compatible AI agent hosts
Compact MCP surface area preferred over a large static tool inventory
ChatGPT is a likely primary host target, while keeping the server usable from other MCP hosts where practical

How It Works

Request → packages/worker/src/index.ts
              │
              ├─→ OAuth handlers
              ├─→ MCP endpoints
              ├─→ Static assets (`packages/worker/public/`)
              └─→ Server router → Remix components

packages/worker/src/index.ts is the entrypoint for Cloudflare Workers
OAuth requests are handled first, then MCP requests, then static assets
Non-asset requests fall through to the server handler and router
Client assets are bundled into packages/worker/public/ and served via the ASSETS binding

Documentation

Document	Description
`docs/contributing/getting-started.md`	Setup, environment variables, deploy
`docs/contributing/environment-variables.md`	Adding new env vars
`docs/contributing/cloudflare-offerings.md`	Optional Cloudflare integrations
`docs/contributing/project-intent.md`	Scope, goals, and non-goals
`docs/contributing/index.md`	Developing and extending Kody
`docs/use/index.md`	Using Kody over MCP
`docs/contributing/setup.md`	Local development and verification

Contributing

Outside pull requests to this repository need a signed inbound Contributor License Agreement. Community packages stay MIT and do not use that CLA.

See CONTRIBUTING.md and docs/contributing/index.md.

License

Python

BSD-3-Clause

View repository →