Beeminder

You can connect to Beeminder data and actions through a lightweight MCP server, enabling your AI tools to read goals, create datapoints, and manage user information via a standard protocol. This server exposes Beeminder functionality in a way that lets MCP hosts securely access Beeminder data from local or remote clients.

How to use

You interact with the Beeminder MCP server through an MCP client. Once the server is running, you can perform common Beeminder actions from your AI assistant, such as listing your goals, creating or updating a datapoint, and retrieving user information. Use the client to request these capabilities and the server will handle communication with Beeminder on your behalf.

How to install

Prerequisites you need before starting are your Beeminder API key and Beeminder username, plus a runtime that can launch MCP servers from the command line.

Follow these steps to set up the Beeminder MCP server for Claude Desktop (local, via MCP protocol):

• Clone the repository that contains the Beeminder MCP server.
• Prepare a Claude Desktop configuration file and point it to the MCP server via the provided command and environment variables.
• Run Claude Desktop and verify you can list or read Beeminder data through the MCP channel.

Additional notes

Configuration focus: the server runs as a local process that the Claude Desktop app can start and manage. You must supply your Beeminder API key and username in the configuration. The server exposes support for managing goals and datapoints, as well as retrieving user information.

{
  "mcpServers": {
    "beeminder": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/repo/mcp-beeminder",
        "run",
        "mcp-beeminder"
      ],
      "env": {
        "BEEMINDER_API_KEY": "YOUR_BEEMINDER_API_KEY",
        "BEEMINDER_USERNAME": "YOUR_BEEMERMIN_USERNAME"
      }
    }
  }
}
```}]}] ,

{
  "mcpServers": {
    "beeminder": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/repo/mcp-beeminder",
        "run",
        "mcp-beeminder"
      ],
      "env": {
        "BEEMINDER_API_KEY": "YOUR_BEEMINDER_API_KEY",
        "BEEMINDER_USERNAME": "YOUR_BEEMERMIN_USERNAME"
      }
    }
  }
}

Troubleshooting

If you run into issues starting the MCP server, confirm that the environment variables are set in the configuration and that the specified directory contains the Beeminder MCP server package. Use Claude Desktop’ s debugging tools to surface any startup or connection errors and verify that the server reports its available Beeminder endpoints.

Security and access

Keep your Beeminder API key secret. Treat the MCP server as a trusted bridge between your AI client and Beeminder. Do not expose API credentials in logs or shared configurations.

Available tools

listGoals

Retrieve the list of Beeminder goals for your account

getGoal

Fetch details for a specific Beeminder goal by ID or slug

createGoal

Create a new Beeminder goal with specified parameters

updateGoal

Update properties of an existing Beeminder goal

deleteGoal

Delete a Beeminder goal

listDatapoints

List datapoints for a given Beeminder goal

createDatapoint

Add a new datapoint to a Beeminder goal

deleteDatapoint

Remove a datapoint from a Beeminder goal

getUserInfo

Retrieve information about the authenticated Beeminder user