Skip to content
Back to search

mcp-server-shortcut

The MCP server for Shortcut

Safety scan

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

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/useshortcut--mcp-server-shortcut/badge.svg)](/listings/useshortcut--mcp-server-shortcut)

HTML

<a href="/listings/useshortcut--mcp-server-shortcut"><img src="/api/listings/useshortcut--mcp-server-shortcut/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 · 147 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. # @shortcut/mcp
  2. ## Usage
  3. ### Windsurf
  4. See the [official Windsurf docs](https://codeium.com/docs/windsurf/mcp) for more information.
  5. 1. Open the `Windsurf MCP Configuration Panel`
  6. 2. Click `Add custom server`.
  7. 3. Add the following details and save the file:
  8. ```json
  9. {
  10. "mcpServers": {
  11. "shortcut": {
  12. "command": "npx",
  13. "args": [
  14. "-y",
  15. "@shortcut/mcp@latest"
  16. ],
  17. "env": {
  18. "SHORTCUT_API_TOKEN": "<YOUR_SHORTCUT_API_TOKEN>"
  19. }
  20. }
  21. }
  22. }
  23. ```
  24. ### Cursor
  25. [![Install MCP Server](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/install-mcp?name=shortcut&config=eyJjb21tYW5kIjoibnB4IC15IEBzaG9ydGN1dC9tY3BAbGF0ZXN0IiwiZW52Ijp7IlNIT1JUQ1VUX0FQSV9UT0tFTiI6IjxZT1VSX1NIT1JUQ1VUX0FQSV9UT0tFTj4ifX0%3D)
  26. See the [official Cursor docs](https://docs.cursor.com/context/model-context-protocol) for more information.
  27. 1. Open (or create) the `mcp.json` file (it should be in `~/.cursor/mcp.json` or `<project-root>/.cursor/mcp.json`, but see Cursor docs for more details).
  28. 2. Add the following details and save the file:
  29. ```json
  30. {
  31. "mcpServers": {
  32. "shortcut": {
  33. "command": "npx",
  34. "args": [
  35. "-y",
  36. "@shortcut/mcp@latest"
  37. ],
  38. "env": {
  39. "SHORTCUT_API_TOKEN": "<YOUR_SHORTCUT_API_TOKEN>"
  40. }
  41. }
  42. }
  43. }
  44. ```
  45. ### Claude Code
  46. See the [official Claude Code docs](https://docs.anthropic.com/en/docs/agents-and-tools/claude-code/tutorials#set-up-model-context-protocol-mcp) for more information.
  47. _You can add a new MCP server from the Claude Code CLI. But modifying the json file directly is simpler!_
  48. 1. Open the Claude Code configuration file (it should be in `~/.claude.json`).
  49. 2. Find the `projects` > `mcpServers` section and add the following details and save the file:
  50. ```json
  51. {
  52. "projects": {
  53. "mcpServers": {
  54. "shortcut": {
  55. "command": "npx",
  56. "args": [
  57. "-y",
  58. "@shortcut/mcp@latest"
  59. ],
  60. "env": {
  61. "SHORTCUT_API_TOKEN": "<YOUR_SHORTCUT_API_TOKEN>"
  62. }
  63. }
  64. }
  65. }
  66. }
  67. ```
  68. ## Issues and Troubleshooting
  69. Before doing anything else, please make sure you are running the latest version!
  70. If you run into problems using this MCP server, you have a couple of options:
  71. - Open an issue on [GitHub](https://github.com/useshortcut/mcp-server-shortcut/issues)
  72. - Ask for help in the community [Slack](https://shortcut.com/join-slack)
  73. You can also check the list of [common issues](#common-issues) below to see if there is a known solution already.
  74. ### Common Issues and Solutions
  75. #### NPX command not working when using MISE for version management
  76. If you are using MISE for managing Node and NPM versions, you may encounter a "Client closed" error when trying to run the MCP server. Installing this extension into your IDE might help: https://github.com/hverlin/mise-vscode/.
  77. ## Development
  78. ### Installation
  79. ```bash
  80. npm install
  81. ```
  82. ### Build
  83. ```bash
  84. npm run build
  85. ```
  86. ### Running the Development Server Locally
  87. To test your local development version of the MCP server rather than using the published package, follow these steps:
  88. 1. Build the project:
  89. ```bash
  90. npm run build
  91. ```
  92. 2. Create or modify your `mcp.json` file to reference your local build:
  93. ```json
  94. {
  95. "mcpServers": {
  96. "shortcut": {
  97. "command": "node",
  98. "args": [
  99. "/path/to/your/local/mcp-server-shortcut/dist/index.js"
  100. ],
  101. "env": {
  102. "SHORTCUT_API_TOKEN": "<YOUR_SHORTCUT_API_TOKEN>"
  103. }
  104. }
  105. }
  106. }
  107. ```
  108. 3. Place this `mcp.json` file in one of the following locations:
  109. - For Cursor: In your home directory (`~/.cursor/mcp.json`) or in your project directory (`.cursor/mcp.json`)
  110. - For Windsurf: Use the MCP Configuration Panel to add the custom server
  111. 4. Restart your AI assistant (Cursor or Windsurf) to load the new configuration.
  112. This allows you to instantly test changes to the MCP server without having to publish a new version.

Ratings and comments

Sign in to rate this skill.

Sign in

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