About tday connector
tday connector lets coding agents record narrated demos of an app feature using a separate local app instance, then upload footage for editing and sharing in tday. It is for developers who want to document features across web, desktop, terminal, and simulator-based apps.
Key features
- 01Records app demos through a coding agent
- 02Uses a separate app instance with throwaway data
- 03Checks footage for possible on-screen secrets
- 04Uploads footage and demo metadata to tday
Use cases
- 01Recording a newly built feature
- 02Checking which features lack demos in Claude Code
MCP support
The connector adds the `tday` MCP server, which runs locally over stdio and provides the coding agent with tday demo-recording capabilities.
Configuration
Remote servers need no local install. Pick your client, then copy the config or install in one click.
https://tday.com/api/mcpclaude mcp add --transport http com-tday-connector https://tday.com/api/mcp{"mcpServers":{"com-tday-connector":{"type":"http","url":"https://tday.com/api/mcp"}}}Open in Cursor{"servers":{"com-tday-connector":{"type":"http","url":"https://tday.com/api/mcp"}}}Open in VS Code{"mcpServers":{"com-tday-connector":{"type":"http","url":"https://tday.com/api/mcp"}}}{"mcpServers":{"com-tday-connector":{"serverUrl":"https://tday.com/api/mcp"}}}Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.
Tools
Details
From the project READMEtday for coding agents
Record narrated demo videos of your app with the coding agent you already use. Ask your agent to "record a tday demo of the newest feature": it starts a separate demo copy of your app on your computer, walks through the feature one narrated line at a time, checks the take for anything private on screen, and uploads it. tday adds the voice, the cursor, the camera moves and the style, and the demo arrives in tday ready to edit and share.
It works with web apps, desktop apps built on Electron, terminal tools, iPhone apps in the iOS Simulator, Android apps on the emulator and Mac apps. You need a tday account (tday.com).
Install
Claude Code
claude plugin install tday --marketplace tday-com/tday-plugins
Or inside a session: /plugin marketplace add tday-com/tday-plugins, then /plugin install tday@tday.
Cursor
git clone https://github.com/tday-com/tday-plugins.git ~/.cursor/plugins/local/tday
Then run Developer: Reload Window in Cursor.
Only the MCP server, in one click
These add the tday MCP server alone (no skill or commands) to Cursor or VS Code, pinned to this
version. Use them or the plugin, not both.
Codex
codex plugin marketplace add tday-com/tday-plugins
codex plugin add tday@tday
Grok Build
grok plugin marketplace add tday-com/tday-plugins
grok plugin install tday
First use
Ask your agent to record a demo. The first time, it calls tday_sign_in, which shows you a link
and a code. Open the link on any device where you are signed in to tday (it opens by itself when
this computer has a browser), check the code matches and choose Authorize; the agent carries
on. It works the same from a sandbox, a cloud machine or over SSH. The sign-in is
saved in ~/.tday/config.json on your computer, readable only by you, and every coding agent on
the computer uses it. It lasts 90 days.
In Claude Code you can also type /tday:demo (optionally with a feature name) or
/tday:demos-needed to see which features have no demo yet.
What it runs and what it sends
- The tday MCP server. The plugin adds one MCP server,
tday, which your agent starts withnpx --prefix ~/ -y @tday-com/[email protected] serve: the@tday-com/mcppackage from npm, pinned to that version. It runs on your computer over stdio, in your repo; npx resolves it from your home directory so your repo's own package.json is never read. The package is published by tday's release workflow only, under its own license. - What leaves your computer. The demo footage and the screens you choose to upload, and
metadata about them (the feature, the steps, the narration). Never your source code,
.envvalues or secrets: a take with a possible secret on screen is held back until it is fixed. See what leaves your machine and demo safety. - Who it talks to. tday (
tday.com), with your sign-in. The npm registry, once a day, to see whether a newer version is out. GitHub's or GitLab's public API, without a token, to check whether your repo is public before a note is saved in it (sending only the repo's name). For a terminal demo, a symbols font fromcdn.jsdelivr.net. - On your computer. A separate demo instance of your app with throwaway data (your own server
and data are never touched), a browser or simulator to record it in, and scratch files under
~/.tday/capture, removed at the end. Notes on how your app was started go in your repo's.tdayfolder, and nothing is committed for you.
The plugin also carries a skill with the steps the agent follows, and the two commands above.
Links
License
The files in this repository are licensed under the MIT license (see LICENSE). The
@tday-com/mcp package they start is distributed on npm under its own license.
The tday name, the tday logo and Cali (the icon in assets/) are tday's trademarks. The license does
not grant permission to use them.
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.