Skip to content
Back to search

studio-ninja-mcp

Connect Studio Ninja to ChatGPT, Claude and other AI agents through Cotlet.dev.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/cotlet-connect--studio-ninja-mcp/badge.svg)](/listings/cotlet-connect--studio-ninja-mcp)

HTML

<a href="/listings/cotlet-connect--studio-ninja-mcp"><img src="/api/listings/cotlet-connect--studio-ninja-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 129 lines
  1. # Studio Ninja MCP server for Claude and ChatGPT
  2. Studio Ninja has no public API or Zapier app. Cotlet runs a hosted Studio Ninja MCP server with 9 tools for leads, jobs and invoices, in ChatGPT and Claude.
  3. ## What you can ask
  4. > Log a new enquiry as a lead with its job type and date.
  5. > List leads that have gone quiet and prepare follow-ups.
  6. > Book a lead as a job with its Studio Ninja workflow.
  7. > Send the contract or invoice after I approve it.
  8. > List overdue invoices and payments due soon.
  9. ## Connect in 2 minutes
  10. Get your API key at https://cotlet.dev/app and export it as `COTLET_API_KEY`.
  11. ### Claude Code
  12. ```bash
  13. claude mcp add --transport http cotlet https://cotlet.dev/mcp/v1 --header "Authorization: Bearer $COTLET_API_KEY"
  14. ```
  15. ### ChatGPT
  16. Settings → Apps → add connector URL `https://cotlet.dev/mcp/v1`, then sign in with Cotlet.dev. No API key needed.
  17. ### Cursor
  18. Copy `.cursor/mcp.json` from this repo into your project:
  19. ```json
  20. {
  21. "mcpServers": {
  22. "cotlet": {
  23. "url": "https://cotlet.dev/mcp/v1",
  24. "headers": {
  25. "Authorization": "Bearer ${COTLET_API_KEY}"
  26. }
  27. }
  28. }
  29. }
  30. ```
  31. ## Run it locally (stdio)
  32. This repo is a real MCP server. It speaks MCP over stdio, lists its Studio Ninja tools without any key, and forwards every tool call to the hosted Cotlet.dev server. The hosted URL above stays the recommended way. Use this when your client only starts local servers.
  33. ```json
  34. {"mcpServers":{"studio-ninja":{"command":"uvx","args":["studio-ninja-mcp"],"env":{"COTLET_API_KEY":"your-key"}}}}
  35. ```
  36. Or with Docker:
  37. ```bash
  38. docker build -t studio-ninja-mcp .
  39. docker run -i --rm -e COTLET_API_KEY studio-ninja-mcp
  40. ```
  41. Tools: `studio_ninja_guide`, `studio_ninja_status`, `studio_ninja_open`, `studio_ninja_read`, `studio_ninja_click`, `studio_ninja_type`, `studio_ninja_close`. Without `COTLET_API_KEY` a tool call answers: "Set COTLET_API_KEY. Get a key at https://cotlet.dev/app".
  42. ## Command line
  43. Python 3.10+, nothing else to install. From PyPI:
  44. ```bash
  45. pip install studio-ninja-mcp # or run it once: uvx studio-ninja-mcp connect
  46. studio-ninja-mcp connect
  47. ```
  48. Or straight from this repo:
  49. ```bash
  50. export COTLET_API_KEY="your-key"
  51. python3 studio_ninja_agent.py connect # ready config for Claude Code, Cursor, ChatGPT
  52. python3 studio_ninja_agent.py status # is Studio Ninja ready in your Cotlet.dev account
  53. python3 studio_ninja_agent.py guide # Studio Ninja screens and sign-in link
  54. python3 studio_ninja_agent.py read # open Studio Ninja, read the page, close the browser
  55. python3 studio_ninja_agent.py tools # list Cotlet.dev tools
  56. python3 studio_ninja_agent.py serve # start the stdio MCP server (same as no argument)
  57. ```
  58. ## Questions from Studio Ninja users
  59. **Does Studio Ninja have an official MCP server or API?**
  60. No. Studio Ninja has no official MCP server, public API or Zapier app (checked 8 November 2026). Cotlet is an independent hosted connection.
  61. **How do I connect Studio Ninja to ChatGPT or Claude?**
  62. Sign up at cotlet.dev, sign in to Studio Ninja once in its Cloud Browser and add Cotlet to ChatGPT or Claude, following the steps in your console.
  63. **What can my AI agent do in Studio Ninja?**
  64. It can log enquiries, follow up quiet leads, book jobs with their workflow, send contracts, send invoices and list overdue payments. Anything that reaches another person waits for your approval.
  65. **Can it send an invoice or contract?**
  66. Yes. Cotlet prepares and sends the Studio Ninja invoice or contract only after you approve the action.
  67. **Does it work with Studio Ninja workflows?**
  68. Yes. Booking a job applies the job type workflow as usual, and your agent can complete workflow tasks.
  69. **Is Cotlet affiliated with Studio Ninja?**
  70. No. Cotlet is independent and not affiliated with Studio Ninja or its owner Captura.
  71. ## Find it on
  72. - [Studio Ninja on Cotlet.dev](https://cotlet.dev/integrations/studio-ninja-api-mcp-server?utm_source=github&utm_medium=readme&utm_campaign=studio-ninja&utm_content=find)
  73. - [PyPI package studio-ninja-mcp](https://pypi.org/project/studio-ninja-mcp/)
  74. - [Odel](https://odel.app/modules/cotlet/studio-ninja)
  75. - [mcpbeat](https://mcpbeat.com/mcp-servers/cotlet/studio-ninja/)
  76. - [Step-by-step guide (PDF) on Internet Archive](https://archive.org/details/cotlet-connect-studio-ninja-to-ai-agents-guide)
  77. ## Also works with
  78. - [All apps connected through Cotlet.dev](https://github.com/cotlet-connect)
  79. ---
  80. More: https://cotlet.dev/integrations/studio-ninja-api-mcp-server?utm_source=github&utm_medium=readme&utm_campaign=studio-ninja
  81. Start free: https://cotlet.dev/signup?app=studio-ninja&utm_source=github&utm_medium=readme&utm_campaign=studio-ninja

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.