Index of every page on this site: llms.txt
All skills
n8n-io avatar

/setup-mcps

@273d130 official
by n8n - Workflow Automationn8n-io/n8n211k stars
61,599
Run it yourself

Configure MCP servers for n8n development in OpenCode. Use when the user says /setup-mcps or asks to set up MCP servers for n8n.

  • 1 file
  • 2.2 KB
  • Updated 5 months ago
  • GitHub
Use this Skill: https://skilld.dev/gh/n8n-io/n8n/setup-mcps

Nothing lands on disk. Nothing to clean up.

Fork this Skill

Edit a local copy. It keeps the author and licence.

SKILL.md

≈35 tokens for metadata: the name and description. ≈528 when used: this file.

Description uses 1.8% of example budget

Before choosing a Skill, your Agent reads its name and description. All available Skills share that space.

  • A shorter description leaves more room for other Skills. This entry exceeds our 1% size suggestion.

In our Claude Code example, all Skill names and descriptions share 8,000 characters. This Skill uses ≈145 characters, or 1.8%.

The 1% threshold is a size suggestion. Longer descriptions can still fit.

Your model, settings, and other Skills decide how much text your Agent can read.

Example settings and source

The example uses a 200k-token context and default Claude Code settings. The count includes the name, description, separators, and when_to_use when present. Codex also counts local file paths.

Skit's source and limits: Codex 0.160.1, Claude Code 2.1.292.

MCP Setup for n8n Development in OpenCode

Configure commonly used MCP servers for n8n engineers using OpenCode MCP config.

Instructions

  1. Check which MCPs are already configured by running, if available:
opencode mcp list

Parse by URL or command, not just server name. Skip any MCP whose URL is already present.

Known MCP URLs:

  • Linear: https://mcp.linear.app/mcp
  • Notion: https://mcp.notion.com/mcp
  • Context7: https://mcp.context7.com/mcp
  • Figma: https://mcp.figma.com/mcp
  1. Ask the user which unconfigured MCPs they want to add. If all are already configured, tell the user and stop.
Option Label Description
Linear Linear Linear ticket management with OAuth
Notion Notion Notion workspace integration with OAuth
Context7 Context7 Library documentation lookup
Figma Figma Figma design integration with OAuth
  1. Ask once whether to install in user or project scope.
Scope Config path When to use
user ~/.config/opencode/opencode.json Default. Available in all projects.
project ./opencode.json Only when the user explicitly wants repo-local config.
  1. Add the selected MCP entries under the mcp object in the selected config. Preserve existing config keys and existing MCP entries.
{
  "mcp": {
    "linear": {
      "type": "remote",
      "url": "https://mcp.linear.app/mcp",
      "enabled": true
    },
    "notion": {
      "type": "remote",
      "url": "https://mcp.notion.com/mcp",
      "enabled": true
    },
    "context7": {
      "type": "remote",
      "url": "https://mcp.context7.com/mcp",
      "enabled": true
    },
    "figma": {
      "type": "remote",
      "url": "https://mcp.figma.com/mcp",
      "enabled": true
    }
  }
}
  1. After editing config, tell the user to authenticate OAuth-backed servers with:
opencode mcp auth <server-name>

Use the configured server names, for example linear, notion, or figma. Context7 does not require OAuth by default.

Source: SKILL.md on GitHub

skilld matched fixed text patterns in SKILL.md and file names. Patterns miss obfuscated code.

skilld run checks every file with the same patterns. It asks for approval before it loads a Skill with a behavior marked Needs approval.

No third-party reports yet.

Signed by skilld at 273d130. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub yesterday.

Activeupdated 5 months ago
  • MCP
  • n8n
  • claude
  • setup
  • integration
  • linear
  • notion
  • figma
  • context7

README badge

README badge for n8n-io/n8n/setup-mcps

Configures MCP servers (Linear, Notion, Context7, Figma) for n8n development by checking existing installations, prompting for scope preference per server, and running the appropriate claude mcp add or setup commands. Targets n8n engineers who need to integrate ticket management, workspace docs, and design tools into their Claude MCP environment.

Generated from the current SKILL.md.

What MCPs does this skill set up?
Linear (ticket management), Notion (workspace integration), Context7 (documentation lookup), and Figma (design integration). The skill checks which are already installed and only prompts to add the missing ones.
Do I need to authenticate after setup?
Yes. For Linear, Notion, and Figma, you run `/mcp` in your next Claude session to authenticate via browser. Context7 handles auth automatically during its setup command.
Can I install these MCPs to just one project?
Yes. The skill asks whether each MCP should be installed to user scope (available in all projects) or local scope (this project only).
What if some MCPs are already configured?
The skill checks by URL/command and skips any that are present. If all are already configured, it informs you and exits.

Generated from the current SKILL.md. These answers refresh after source changes.