io.github.BasicOps/basicops
BasicOps MCP server for project management, tasks, notes, and team collaboration.
What can you do with io.github.BasicOps/basicops?
- 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
Install
Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).
claude mcp add --transport http basicops 'https://app.basicops.com/mcp' --header 'Authorization: <BasicOps API key. Required for clients that do not support OAuth 2.1 (e.g. Claude CLI).>'{
"mcpServers": {
"basicops": {
"type": "http",
"url": "https://app.basicops.com/mcp",
"headers": {
"Authorization": "<BasicOps API key. Required for clients that do not support OAuth 2.1 (e.g. Claude CLI).>"
}
}
}
}claude mcp add --transport sse basicops 'https://app.basicops.com/mcp/sse' --header 'Authorization: <BasicOps API key. Required for clients that do not support OAuth 2.1 (e.g. Claude CLI).>'{
"mcpServers": {
"basicops": {
"type": "sse",
"url": "https://app.basicops.com/mcp/sse",
"headers": {
"Authorization": "<BasicOps API key. Required for clients that do not support OAuth 2.1 (e.g. Claude CLI).>"
}
}
}
}Documentation
From the project's README on GitHub, refreshed weekly. Links open on GitHub.
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
Bearertoken in theAuthorizationheader (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/mcpOn 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.
Resources
Support
For support, visit basicops.com or contact us at support@basicops.com.
Frequently asked questions
What is io.github.BasicOps/basicops?
BasicOps MCP server for project management, tasks, notes, and team collaboration.
How do I install io.github.BasicOps/basicops?
It runs as a remote server. In Claude Code: claude mcp add --transport http basicops 'https://app.basicops.com/mcp' --header 'Authorization: <BasicOps API key. Required for clients that do not support OAuth 2.1 (e.g. Claude CLI).>'. For other clients, paste the JSON configuration from this page into their MCP settings.
Does io.github.BasicOps/basicops need an API key?
Yes. It expects Authorization, which you set in its configuration.
Is io.github.BasicOps/basicops open source?
Its code is public on GitHub, but the repository does not declare a standard license.
Who maintains io.github.BasicOps/basicops?
It is published by BasicOps. AI.tn lists it but does not maintain or endorse it.
From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.