Timestamply

npx add-mcp 'https://api.timestamply.io/api/mcp'

Choose where to connect

Open the steps for the app you already use. Once you add Timestamply, sign in and approve access in your browser. If you already added it, go straight to the sign-in step.

Ask your agent to help

Paste this message into your agent chat. Complete the Timestamply sign-in yourself when prompted.

Connect Timestamply to this agent using its remote MCP server: https://api.timestamply.io/api/mcp
Follow the instructions for this client at https://timestamply.io/docs/mcp. If Timestamply is already configured, reuse it. Keep my other MCP settings.
Tell me where to sign in and approve access, and whether I need to open a new chat. Then call get_usage to check the connection. Wait for me to ask before generating chapters.

Codex

In the desktop app

1. Open Settings → MCP servers → Add server.
2. Enter timestamply as the name, choose Streamable HTTP, and paste this URL:

   https://api.timestamply.io/api/mcp
   

3. Save and select Restart. Back in MCP servers, choose Authenticate for Timestamply if prompted. Sign in to Timestamply and approve access in your browser.
4. Open a new Codex chat and check the connection.

In the terminal

1. With the Codex CLI installed, paste this into your terminal to add Timestamply:

   codex mcp add timestamply --url https://api.timestamply.io/api/mcp
   

2. If your browser opens, sign in to Timestamply and approve access. If it does not open or Codex still asks you to sign in, run this command:

   codex mcp login timestamply --scopes usage:read,timecodes:generate --oauth-client-registration dcr
   

3. Start a new Codex session and check the connection. Allow time for video processing

Generation can take several minutes. In ~/.codex/config.toml, update the existing Timestamply section to allow up to 15 minutes per call. Keep your other servers and avoid adding a second section with the same name.

[mcp_servers.timestamply]
url = "https://api.timestamply.io/api/mcp"
tool_timeout_sec = 900

Official Codex setup guide ↗

Claude Code

1. With Claude Code installed, paste this into your terminal to add Timestamply for all your projects:

   claude mcp add --transport http --scope user timestamply https://api.timestamply.io/api/mcp
   

2. Start a new Claude Code session. In the Claude Code chat, type /mcp, select timestamply and choose Authenticate if prompted.
3. In your browser, sign in to Timestamply and approve access. Return to Claude Code and check the connection. If video processing times out

Add "timeout": 900000 to the Timestamply entry under mcpServers in ~/.claude.json, then restart Claude Code. This lets a call run for up to 15 minutes. Preserve the other settings.

{
  "type": "http",
  "url": "https://api.timestamply.io/api/mcp",
  "timeout": 900000
}

Official Claude Code setup guide ↗

Cursor

1. On a computer with Cursor installed, click below, allow your browser to open Cursor, and confirm the installation in Cursor. Add to Cursor ↗
2. In Cursor, open Customize in the sidebar and make sure Timestamply is enabled. Use its sign-in prompt to open your browser, sign in and approve access.
3. Open an Agent chat in Cursor and check the connection. Or add the configuration manually

If the button does not open Cursor, add this configuration to ~/.cursor/mcp.json for all projects, or .cursor/mcp.json for one project. If the file already has an mcpServers object, add only the timestamply entry inside it. Save, then follow steps 2 and 3 above.

{
  "mcpServers": {
    "timestamply": {
      "url": "https://api.timestamply.io/api/mcp"
    }
  }
}

Official Cursor setup guide ↗

Check the connection

Paste this into your agent chat:

Use Timestamply to check my remaining video quota.

If your agent returns the remaining video quota for your account, you’re connected. If it can’t find Timestamply, check that the server is enabled and signed in, then start a new chat.

To generate chapters, ask: “Generate YouTube chapters with Timestamply for this video: [paste your YouTube link].”

Checking your quota is free. Generating chapters uses the video allowance on your Timestamply plan, just like the website. Video duration limits still apply.

Reference

Using another client? It needs to support Streamable HTTP and OAuth with dynamic client registration. Add this URL and sign in with your Timestamply account.

https://api.timestamply.io/api/mcp

get_usage

Check your plan, remaining video quota and video duration limit.

generate_timecodes

Generate chapters using an 11-character YouTube video ID.