@morphixai/mcp-server

<p align="center"> <a href="https://morphix.app"> <img src="https://morphix.app/brand/logo-rounded.png" alt="MorphixAI" width="80" /> </a> </p>

<h1 align="center">MorphixAI AI Agent Plugins</h1>

<p align="center"> <a href="https://morphix.app">morphix.app</a> </p>

<p align="center"> <strong>English</strong> | <a href="./README.zh-CN.md">简体中文</a> </p>

This repository contains the official integrations for MorphixAI, allowing various AI Agents (such as OpenClaw, Claude Code, Cursor, and Windsurf) to seamlessly interact with workplace tools like GitHub, GitLab, Jira, Notion, Google Workspace, and Office 365.

📦 Architecture

This repository is structured as a pnpm workspace monorepo to ensure maximum code reuse and pure dependency trees for different platforms.

• @morphixai/core: The platform-agnostic core engine. It contains all API clients, authentication logic, and TypeBox schemas.
• openclaw-morphixai: The adapter for OpenClaw. It exposes tools and skill prompts native to the OpenClaw Agent ecosystem.
• @morphixai/mcp-server: The adapter for MCP (Model Context Protocol). It exposes the core capabilities as a standard MCP server, making it compatible with Claude Code, Cursor, and Claude Desktop.

---

🚀 Installation & Usage

1. For Claude Code, Cursor, Windsurf (MCP Users)

If your AI assistant supports the Model Context Protocol (MCP), you can install the MorphixAI server globally.

# 1. Install the MCP server globally
npm install -g @morphixai/mcp-server

For Claude Code: Add the MCP server to your Claude Code configuration by passing your Morphix API Key:

claude mcp add morphixai-mcp -- npx -y @morphixai/mcp-server --env MORPHIXAI_API_KEY="mk_your_api_key_here"

For Claude Desktop / Cursor: Add the following to your claude_desktop_config.json or Cursor MCP settings:

{
  "mcpServers": {
    "morphixai": {
      "command": "npx",
      "args": ["-y", "@morphixai/mcp-server"],
      "env": {
        "MORPHIXAI_API_KEY": "mk_your_api_key_here"
      }
    }
  }
}

2. For OpenClaw Users

Install the plugin directly within your OpenClaw environment:

openclaw plugins install openclaw-morphixai

Note: The legacy package openclaw-morphix has been deprecated, but installing it will safely proxy to openclaw-morphixai.

---

🔑 Getting Started

1. Register / Login: Visit morphix.app to create your MorphixAI account or sign in.
2. Get your API Key: Go to MorphixAI API Keys and create a new key (format: mk_xxxxxx).
3. Link your accounts (optional): Visit MorphixAI Connections to connect third-party platforms (GitHub, Jira, Notion, etc.) that you want to use through AI agents.
4. Configure your environment: Pass the key via the MORPHIXAI_API_KEY environment variable, then follow the Installation instructions above for your AI agent.

🧩 Skills

MorphixAI provides the following skills (capabilities) for AI agents to interact with workplace tools:

Skill	Tool	Description
GitHub Workflow	mx_github	Repository, Issue, Pull Request management and GitHub Actions workflow triggering
GitLab Workflow	mx_gitlab	MR/Issue/Pipeline/Branch management with code review best practices
Jira Workflow	mx_jira	Project listing, JQL-based issue search, issue CRUD, status transitions, comments (Markdown auto-converts to ADF)
Notion	mx_notion	Page/database CRUD, block management, knowledge base search
Confluence	mx_confluence	Space/page CRUD, label management, comments, CQL search
Figma	mx_figma	Browse projects/files, export images, manage comments, view components/styles/design tokens
Outlook Email	mx_outlook	List/search/send/reply messages, folder management
Outlook Calendar	mx_outlook_calendar	Calendar/event CRUD, calendar view, attendee management
Gmail	mx_gmail	List/search/send messages, label management (requires linking Gmail account)
Microsoft To Do	mx_ms_todo	Task list and task CRUD, complete tasks, importance/status management
Google Tasks	mx_google_tasks	Task list and task CRUD (requires linking Google Tasks account)
Flights	mx_flights	Airport/flight search, offer details, seat maps, order booking and management (powered by Duffel)
Daily Standup	composite	Aggregates data from GitLab, GitHub, Jira, Email, Calendar, and Tasks into a concise daily report. Triggered by keywords like "standup", "日报", "早报"
Office Link	mx_link	Unified entry point: account management, connect 40+ platforms, and API proxy for platforms without dedicated skills

Note: All skills require a MORPHIXAI_API_KEY. Platforms with dedicated skills (e.g., GitHub, Jira) should always use those skills directly instead of mx_link proxy.

---

🛠️ Development

# Install dependencies
pnpm install

# Build all packages
pnpm build

# Run tests
pnpm test

License

MIT