{
  "markdown": "# BasicOps MCP Server\n\nThe official [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) server for [BasicOps](https://basicops.com) — a project management platform for tasks, notes, and team collaboration.\n\nConnect any MCP-compatible AI client (Claude, Cursor, Windsurf, etc.) to your BasicOps workspace and manage your work using natural language.\n\n## Endpoints\n\n| Transport | URL |\n|---|---|\n| Streamable HTTP | `https://app.basicops.com/mcp` |\n| SSE (legacy) | `https://app.basicops.com/mcp/sse` |\n\n## Authentication\n\nThe BasicOps MCP server supports two authentication methods:\n\n### OAuth 2.1 (recommended)\n\nMost 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.\n\n### API Key\n\nFor clients that do not support OAuth token refresh (such as Claude CLI / Claude Code), you can authenticate using a BasicOps API key instead.\n\n1. In BasicOps, go to **Settings → API Keys** and generate a new key. Copy the key — it is only shown once.\n2. Configure your MCP client to send the key as a `Bearer` token in the `Authorization` header (see client-specific instructions below).\n\nAPI keys do not expire by default but can be revoked at any time from Settings → API Keys.\n\n## Features\n\nThe BasicOps MCP server exposes tools for working with your entire BasicOps workspace:\n\n- **Projects** — create, update, list, and archive projects\n- **Tasks & Subtasks** — create, update, assign, prioritize, and complete tasks\n- **Sections** — organize tasks within projects using sections\n- **Notes** — create and manage project notes\n- **Messages** — post and reply to messages in projects and tasks\n- **Templates** — list and manage project templates\n- **Users** — look up team members and current user info\n- **File Attachments** — upload and attach files to tasks\n\n## Getting Started\n\n### 1. Configure your MCP client\n\n#### Claude Desktop\n\nIn Claude Desktop, add a new MCP connector using the custom connector option. Enter a name (e.g. `BasicOps`) and the Streamable HTTP endpoint:\n\n```\nhttps://app.basicops.com/mcp\n```\n\nOn first use, you will be prompted to sign in to BasicOps via the OAuth 2.1 authorization flow.\n\n#### Claude CLI / Claude Code\n\nClaude CLI does not support OAuth token refresh, so use an API key instead. Generate one in BasicOps Settings → API Keys, then run:\n\n```bash\nclaude mcp add basicops \\\n  --transport http \\\n  https://app.basicops.com/mcp \\\n  --header \"Authorization: Bearer bo_YOUR_API_KEY\"\n```\n\nOr add it manually to your `~/.claude.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"basicops\": {\n      \"type\": \"http\",\n      \"url\": \"https://app.basicops.com/mcp\",\n      \"headers\": {\n        \"Authorization\": \"Bearer bo_YOUR_API_KEY\"\n      }\n    }\n  }\n}\n```\n\n#### Other clients\n\nUse the Streamable HTTP endpoint `https://app.basicops.com/mcp`. For clients that only support SSE, use `https://app.basicops.com/mcp/sse` instead.\n\nClients 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`.\n\n## Resources\n\n- [BasicOps](https://basicops.com)\n- [BasicOps App](https://app.basicops.com)\n- [MCP Documentation](https://modelcontextprotocol.io)\n\n## Support\n\nFor support, visit [basicops.com](https://basicops.com) or contact us at support@basicops.com.\n",
  "bytes": 3482,
  "sha": "027ee7f0a5f3d5786e15dc6d6146071163da35ff41d92884d9c73268c8b2a441",
  "repo_slug": "basicops/mcp-server",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_basicops_basicops_1a4e6b4b/readme"
}