@beatos/mcp-server
v0.1.0
Published
Model Context Protocol server for BeatOS — lets Claude and other MCP-capable AI assistants manage your tasks, habits, projects, and reviews.
Downloads
27
Maintainers
Readme
@beatos/mcp-server
Model Context Protocol (MCP) server for BeatOS. Lets Claude, ChatGPT, and other MCP-capable AI assistants manage your tasks, habits, projects, and reviews through natural conversation.
Remote HTTP endpoint is the recommended path — no install required. See docs.beatos.app/docs/mcp-setup. This npm package is for users who want a local stdio server (offline dev, custom proxying, or clients that don't support HTTP MCP).
Quick start
npx @beatos/mcp-serverThe server reads its configuration from environment variables and speaks MCP over stdio — you don't run it standalone; your MCP client spawns it.
Claude Code / Claude Desktop
Add to your .mcp.json (project-level) or Claude Desktop config:
{
"mcpServers": {
"beatos": {
"command": "npx",
"args": ["@beatos/mcp-server"],
"env": {
"API_BASE_URL": "https://mcp.beatos.app",
"API_TOKEN": "pgtd_your_api_key_here"
}
}
}
}Replace pgtd_your_api_key_here with an API key from BeatOS → Settings → API Keys. (API keys retain the pgtd_ prefix for backwards compatibility with existing keys.)
Environment variables
| Variable | Default | Description |
|----------|---------|-------------|
| API_BASE_URL | https://mcp.beatos.app | BeatOS MCP API URL |
| API_TOKEN | (empty) | API key (prefix pgtd_) from BeatOS Settings |
Available tools
The server exposes 18 tools across tasks, projects, habits, reviews, and organization. Full list: docs.beatos.app/docs/mcp-setup.
Links
- Full documentation: https://docs.beatos.app/docs/mcp-setup
- Web app: https://beatos.app
- Issues: file via BeatOS support (the source monorepo is private)
Contributing
This package is built from the private BeatOS monorepo. If you're a contributor with repo access:
pnpm install
pnpm --filter @beatos/mcp-server buildLicense
MIT © Daniel Gordon
