Shortcut

Provides an MCP server for Shortcut enabling clients to exchange data and commands via the MCP protocol.

typescript

5

GitHub Stars

typescript

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "madisonbullard-shortcut-mcp-server": {
      "command": "bun",
      "args": [
        "run",
        "packages/shortcut-mcp-server/dist/index.js"
      ]
    }
  }
}

You use MCP servers to expose programmable endpoints that clients can connect to, enabling standardized interactions for apps like Shortcut. This server setup provides a ready-made MCP endpoint you can host locally or in CI, with a companion installer CLI and client libraries to streamline integration.

How to use

You run the MCP server locally and optionally install a specific server bundle with its installer CLI. The server accepts client requests from MCP clients (such as Shortcut clients) and handles the protocol, data exchange, and actions defined by the MCP implementation. To get started, start the Shortcut MCP Server and then run the client against the running server. If you use the dedicated installer CLI, you can install and set up the Shortcut MCP server with a single command and then run the server as described.

How to install

Prerequisites you need before installation:

A JavaScript runtime compatible with Bun commands (Bun is used for development and running the server and installer in examples).
Access to run commands in your shell with the ability to install dependencies and execute built artifacts.

Step 1: Install the Shortcut MCP Server installer (CLI) so you can install the server for Shortcut.

bun run packages/shortcut-mcp-server-installer/dist/index.js

Step 2: Install the Shortcut MCP Server using the installer. Follow the prompts provided by the installer to complete the setup.

Step 3: Run the Shortcut MCP Server locally so clients can connect.

bun run packages/shortcut-mcp-server/dist/index.js

Step 4: If you need to run a client or test locally, connect your MCP client to the running server endpoint as described by your client’s documentation. The server will handle incoming MCP requests and respond accordingly.

Additional sections

Notes on development and tooling are provided in the MonoRepo context. You can build all packages with Bun, which outputs distribution files to dist folders for each package. The standard workflow for development is to build the entire monorepo and then run the compiled server or CLI as needed.

Available tools

TUI

A text-based user interface to help install MCP servers for various clients, simplifying setup and configuration.

Shortcut MCP Server

An MCP server implementation dedicated to the Shortcut client ecosystem, handling MCP requests and responses.

Shortcut MCP Installer CLI

A command-line interface to install the Shortcut MCP server locally with guided prompts and setup steps.

Shortcut API Client

A client library for interacting with the Shortcut MCP server APIs programmatically.

Notion MCP Server

An MCP server implementation for Notion integration within the MCP ecosystem.

Notion MCP Installer CLI

A CLI to install and configure the Notion MCP server.

Coderabbit MCP Server

An MCP server implementation for Coderabbit within the MCP ecosystem.

Coderabbit API Client

A client library for interacting with the Coderabbit MCP server APIs programmatically.