Workers + Stytch TODO App MCP Server
About
This is a Cloudflare Workers application that combines a React/Vite static website, a Hono REST API backed by Workers KV, and a Model Context Protocol (MCP) server built on Workers Durable Objects. It uses Stytch Consumer authentication to manage user identity and demonstrates…
Details
- License
- MIT
Explore
- Composes React frontend, Hono API, and MCP server.
- User authentication via Stytch Consumer product.
- Data stored in Workers KV and Durable Objects.
- One-click deploy to Cloudflare Workers.
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Workers + Stytch TODO App MCP ServerCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
After completing all the setup steps above the application can be run with the command:
npm run dev
The application will be available at http://localhost:3000 and the MCP server will be available at http://localhost:3000/mcp.
Test your MCP server using the MCP Inspector
npx @modelcontextprotocol/inspector@latest
Navigate to the URL where the Inspector is running, and input the following values:
- Transport Type: Streamable HTTP
- URL: http://localhost:3000/mcp
Click the button - you'll need to configure environment variables after the initial deployment.
Or, if you want to follow the steps by hand:
1. Create a KV namespace for the TODO app to use
wrangler kv namespace create TODOS
2. Update the KV namespace ID in wrangler.jsonc with the ID you received:
"kv_namespaces": [
{
"binding": "TODOS",
"id": "your-kv-namespace-id"
}
]
3. Upload your Stytch Env Vars for use by the worker
npx wrangler secret bulk .dev.vars
4. Deploy the worker
npm run deploy
5. Grant your deployment access to your Stytch project. Assuming your Stytch project was deployed at https://mcp-stytch-consumer-todo-list.$YOUR_ACCOUNT_NAME.workers.dev:
1. Add https://mcp-stytch-consumer-todo-list.$YOUR_ACCOUNT_NAME.workers.dev/authenticate as an allowed Redirect URL
2. Add https://mcp-stytch-consumer-todo-list.$YOUR_ACCOUNT_NAME.workers.dev as an allowed Authorized Application in the Frontend SDKs configuration
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"workers + stytch todo app mcp server": {
"mcp-stytch-consumer-todo-list": {
"command": "npx",
"args": [
"@modelcontextprotocol/inspector@latest"
]
}
}
}
}McpServers
{
"mcp-stytch-consumer-todo-list": {
"command": "npx",
"args": [
"@modelcontextprotocol/inspector@latest"
]
}
}This is a Workers server that composes three functions:
A static website built using React and Vite on top of Worker Assets
A REST API built using Hono on top of Workers KV
- A Model Context Protocol Server built using on top of Workers Durable Objects
User and client identity is managed using Stytch. Put together, these three features show how to extend a traditional full-stack application for use by an AI agent.
This demo uses the Stytch Consumer product, which is purpose-built for Consumer SaaS authentication requirements.
If you are more interested in Stytch's B2B product, see this demo instead.
Set up
Follow the steps below to get this application fully functional and running using your own Stytch credentials.
In the Stytch Dashboard
1. Create a Stytch account. Within the sign up flow select Consumer Authentication as the authentication type you are interested in. Once your account is set up a Project called "My first project" will be automatically created for you.
2. Navigate to Frontend SDKs to enable the Frontend SDK in Test
3. Navigate to Connected Apps to enable Dynamic Client Registration
4. Navigate to Project Settings to view your Project ID and API keys. You will need these values later.
On your machine
In your terminal clone the project and install dependencies:
git clone https://github.com/stytchauth/mcp-stytch-consumer-todo-list.git
cd mcp-stytch-consumer-todo-list
npm i
Next, create an .env.local file by running the command below which copies the contents of .env.template.
cp .env.template .env.local
Open .env.local in the text editor of your choice, and set the environment variables using the public_token found on Project Settings.
```
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
