How do I install Basicops?

Basicops is a remote plugin. You do not need to install anything locally. Add the server URL to your AI app's MCP configuration and you are ready to go.

What AI apps work with Basicops?

Basicops uses the Model Context Protocol (MCP) and works with any MCP-compatible AI app, including Claude, ChatGPT / Codex, Gemini, Copilot, Cursor, and more.

Back to Browse

Basicops MCP Server

by Hans Larsen

Developer ToolsLow Risk10.0Remote

Free

BasicOps MCP server for project management, tasks, notes, and team collaboration.

About

BasicOps MCP server for project management, tasks, notes, and team collaboration.

Remote endpoints: streamable-http: https://app.basicops.com/mcp sse: https://app.basicops.com/mcp/sse

Security Report

10.0

Low Risk10.0Low Risk

Valid MCP server (1 strong, 1 medium validity signals). No known CVEs in dependencies. Imported from the Official MCP Registry.

Endpoint verified · Requires authentication · 2 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

HTTP Network Access

Connects to external APIs or services over the internet.

How to Connect

Remote Plugin

No local installation needed. Your AI client connects to the remote endpoint directly.

Add this to your MCP configuration to connect:

{
  "mcpServers": {
    "io-github-basicops-basicops": {
      "url": "https://app.basicops.com/mcp"
    }
  }
}

Documentation

View on GitHub

From the project's GitHub README.

BasicOps MCP Server

The official Model Context Protocol (MCP) server for BasicOps — a project management platform for tasks, notes, and team collaboration.

Connect any MCP-compatible AI client (Claude, Cursor, Windsurf, etc.) to your BasicOps workspace and manage your work using natural language.

Endpoints

Transport	URL
Streamable HTTP	`https://app.basicops.com/mcp`
SSE (legacy)	`https://app.basicops.com/mcp/sse`

Authentication

The BasicOps MCP server supports two authentication methods:

OAuth 2.1 (recommended)

Most MCP clients (Claude Desktop, Cursor, Windsurf, etc.) support OAuth 2.1. When you connect, you will be redirected through the OAuth 2.1 authorization flow to grant access to your BasicOps workspace. No manual token management is required.

API Key

For clients that do not support OAuth token refresh (such as Claude CLI / Claude Code), you can authenticate using a BasicOps API key instead.

In BasicOps, go to Settings → API Keys and generate a new key. Copy the key — it is only shown once.
Configure your MCP client to send the key as a Bearer token in the Authorization header (see client-specific instructions below).

API keys do not expire by default but can be revoked at any time from Settings → API Keys.

Features

The BasicOps MCP server exposes tools for working with your entire BasicOps workspace:

Projects — create, update, list, and archive projects
Tasks & Subtasks — create, update, assign, prioritize, and complete tasks
Sections — organize tasks within projects using sections
Notes — create and manage project notes
Messages — post and reply to messages in projects and tasks
Templates — list and manage project templates
Users — look up team members and current user info
File Attachments — upload and attach files to tasks

Getting Started

1. Configure your MCP client

Claude Desktop

In Claude Desktop, add a new MCP connector using the custom connector option. Enter a name (e.g. BasicOps) and the Streamable HTTP endpoint:

https://app.basicops.com/mcp

On first use, you will be prompted to sign in to BasicOps via the OAuth 2.1 authorization flow.

Claude CLI / Claude Code

Claude CLI does not support OAuth token refresh, so use an API key instead. Generate one in BasicOps Settings → API Keys, then run:

claude mcp add basicops \
  --transport http \
  https://app.basicops.com/mcp \
  --header "Authorization: Bearer bo_YOUR_API_KEY"

Or add it manually to your ~/.claude.json:

{
  "mcpServers": {
    "basicops": {
      "type": "http",
      "url": "https://app.basicops.com/mcp",
      "headers": {
        "Authorization": "Bearer bo_YOUR_API_KEY"
      }
    }
  }
}

Other clients

Use the Streamable HTTP endpoint https://app.basicops.com/mcp. For clients that only support SSE, use https://app.basicops.com/mcp/sse instead.

Clients that support OAuth 2.1 will be redirected through the authorization flow automatically. Clients that do not support OAuth can pass an API key as Authorization: Bearer bo_YOUR_API_KEY.