@ufo-space/mcp-server

MCP server for Space CRM — connect AI assistants (Claude Desktop, Claude Code, Cursor) to your tasks, projects, and time tracking.

Quick Start

Step 1. Install Node.js

Download and install Node.js 18+ from https://nodejs.org

Step 2. Configure Claude Desktop

Open config file:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Add:

{
  "mcpServers": {
    "space": {
      "command": "npx",
      "args": ["-y", "@ufo-space/mcp-server"]
    }
  }
}

That's it — no API keys or passwords needed. OAuth is built-in.

Step 3. Restart Claude Desktop

On first use, a browser window will open asking you to log in to Space CRM and authorize access. After that, tokens are saved and refreshed automatically.

Step 4. Verify

Type in Claude:

Show me my tasks

Configure Claude Code

Add to .claude/mcp.json at the project root:

{
  "mcpServers": {
    "space": {
      "command": "npx",
      "args": ["-y", "@ufo-space/mcp-server"]
    }
  }
}

Custom API URL

If your Space instance is on a different server, either:

Option A — tell Claude at any time:

Set API URL to https://api.yourserver.com

Option B — set in config:

{
  "mcpServers": {
    "space": {
      "command": "npx",
      "args": ["-y", "@ufo-space/mcp-server"],
      "env": {
        "SPACE_API_URL": "https://api.yourserver.com"
      }
    }
  }
}

Authentication

OAuth is the default — no configuration needed. On first use, a browser opens for login.

For advanced use cases, you can override with:

• SPACE_API_TOKEN — Personal Access Token (skips OAuth)
• SPACE_OAUTH_CLIENT_ID / SPACE_OAUTH_CLIENT_SECRET — custom OAuth client

Available tools (28)

Task management

• list_my_tasks — List tasks assigned to you
• list_project_tasks — List tasks in a project
• get_task — Get full task details
• search_tasks — Search tasks by name/tag/description
• get_task_by_tag — Get task by tag (e.g., PROJ-123)
• create_task — Create a new task
• update_task — Update a task

Task sub-resources

• list_task_comments / add_task_comment — Task comments
• list_task_todos / add_task_todo — Task checklists
• list_task_workers / assign_worker — Task assignments
• list_pinned_tasks — Your pinned tasks

Projects & metadata

• list_projects / get_project / get_project_by_tag — Projects
• list_task_statuses / list_task_priorities / list_task_types — Metadata lookups
• list_project_statuses — Project-specific statuses

Time tracking

• get_work_status — Check workday status
• start_workday / end_workday — Start/end your workday
• submit_work_report — Log time on a task
• get_work_time — Get tracked time for a period

Setup

• get_api_url — Show current API URL
• set_api_url — Change API URL (persisted across sessions)

Available scopes

| Scope | Description | |-------|-------------| | tasks:read | View tasks, statuses, priorities | | tasks:write | Create and update tasks | | projects:read | View projects and releases | | projects:write | Create and update projects | | work:read | View attendance and reports | | work:write | Start/end workday, submit reports | | users:read | View users and profiles |

Development

git clone [email protected]:ufo-engineering-crm/claude-connector.git
cd claude-connector
npm install
npm run build

# Test with MCP Inspector
npx @modelcontextprotocol/inspector node dist/index.js

API docs

• Production: https://api.newcrm.projects.od.ua
• Staging: http://api.stage.newcrm.projects.od.ua
• Swagger: http://api.stage.newcrm.projects.od.ua/docs#oauth2