Skip to main content
This guide shows you how to connect Semoia to your AI tools using the Model Context Protocol (MCP).

​
Prerequisites

Before you start, make sure you have:
  1. Semoia Account: Join the beta at the Semoia Dashboard.
  2. API Key: Copy your key from the Settings page.
  3. Node.js: Ensure you have Node.js (18+) installed for the CLI setup.
The easiest way to configure your AI tools is using our CLI tool. It automatically detects and configures supported clients like Cursor, VS Code, and Claude. Run this command in your terminal: 
npx @semoia/install-mcp

​
Alternative: Shell Script

If you prefer using a shell script or need to target a specific client manually:
Terminal
curl -fsSL https://beta.trysemoia.com/scripts/install-mcp.sh | bash
To target a specific supported client: 
curl -fsSL https://beta.trysemoia.com/scripts/install-mcp.sh | bash -s -- cursor
Supported targets: cursor, vscode, windsurf, claude-code, claude-desktop, antigravity, trae, zed, boltai, gemini.

​
What’s Next?

Once installed, your AI agent will have access to new specialized tools:
  • Notebooks: Long-term memory for project details. Learn more
  • Jots: Quick capture for ideas and tasks. Learn more
  • Context Sharing: Seamlessly move conversations between agents. Learn more
Manage your memory and API keys at the Semoia Dashboard.