{"id":46442444,"url":"https://github.com/klauern/openai-orgs","last_synced_at":"2026-03-05T22:09:30.349Z","repository":{"id":259333193,"uuid":"877044819","full_name":"klauern/openai-orgs","owner":"klauern","description":"CLI and Go library for interacting with OpenAI's administration endpoints","archived":false,"fork":false,"pushed_at":"2025-12-15T18:15:54.000Z","size":257,"stargazers_count":1,"open_issues_count":3,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-01-14T21:59:54.848Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/klauern.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":"audit_logs.go","citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2024-10-23T01:50:12.000Z","updated_at":"2025-12-02T01:18:18.000Z","dependencies_parsed_at":"2025-04-26T22:22:04.558Z","dependency_job_id":"1f7159de-128a-4869-92c0-638a92b96c70","html_url":"https://github.com/klauern/openai-orgs","commit_stats":null,"previous_names":["klauern/openai-orgs","klauern/oaiprom"],"tags_count":31,"template":false,"template_full_name":null,"purl":"pkg:github/klauern/openai-orgs","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/klauern%2Fopenai-orgs","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/klauern%2Fopenai-orgs/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/klauern%2Fopenai-orgs/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/klauern%2Fopenai-orgs/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/klauern","download_url":"https://codeload.github.com/klauern/openai-orgs/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/klauern%2Fopenai-orgs/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30152100,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-05T21:15:50.531Z","status":"ssl_error","status_checked_at":"2026-03-05T21:15:11.173Z","response_time":93,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-03-05T22:09:27.469Z","updated_at":"2026-03-05T22:09:30.334Z","avatar_url":"https://github.com/klauern.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# openai-orgs - CLI for OpenAI Platform Management API\n\n[![codecov](https://codecov.io/gh/klauern/openai-orgs/graph/badge.svg?token=7ENEG01SSU)](https://codecov.io/gh/klauern/openai-orgs)\n\n`openai-orgs` is a comprehensive command-line interface (CLI) tool and API client for managing OpenAI Platform Administration APIs. It provides comprehensive management capabilities for OpenAI organizations including projects, users, API keys, service accounts, certificates, audit logs, and more. The project also includes a Model Context Protocol (MCP) server for AI assistant integration.\n\n## Installation\n\n### CLI Tool\n\nTo install `openai-orgs`, make sure you have Go installed on your system, then run:\n\n```bash\ngo install github.com/klauern/openai-orgs/cmd/openai-orgs@latest\n```\n\n### MCP Server\n\nTo install the MCP server:\n\n```bash\ngo install github.com/klauern/openai-orgs/cmd/mcp@latest\n```\n\n### Development Setup\n\nFor development, you can use the included Task runner:\n\n```bash\n# Install Task if you don't have it\ngo install github.com/go-task/task/v3/cmd/task@latest\n\n# Build the CLI\ntask build\n\n# Build the MCP server\ntask mcp:build\n\n# Run tests\ntask test\n```\n\n## Configuration\n\nBefore using `openai-orgs`, you need to set up your OpenAI API key:\n\n1. Log in to your OpenAI account at \u003chttps://platform.openai.com/\u003e\n2. Navigate to the API keys section\n3. Create a new API key\n4. Set the API key as an environment variable:\n\n```bash\nexport OPENAI_API_KEY=your_api_key_here\n```\n\n## Usage\n\n`openai-orgs` uses subcommands to organize its functionality. Here are the main commands:\n\n### Organization Level Commands\n- `audit-logs`: Manage audit logs\n- `invites`: Manage organization invites\n- `users`: Manage organization users\n- `admin-api-keys`: Manage organization admin API keys\n- `certificates`: Manage organization certificates (mutual TLS)\n\n### Project Level Commands\n- `projects`: Manage organization projects\n- `project-users`: Manage project users\n- `project-service-accounts`: Manage project service accounts\n- `project-api-keys`: Manage project API keys\n- `project-rate-limits`: Manage project rate limits\n- `project-certificates`: Manage project certificates\n\n### Output Formats\n\nAll commands support multiple output formats via the `--output` flag:\n- `pretty` (default): Human-readable formatted output\n- `json`: JSON format\n- `jsonl`: JSON Lines format\n\nTo see available subcommands and options for each command, use the `--help` flag:\n\n```bash\nopenai-orgs --help\nopenai-orgs \u003ccommand\u003e --help\n```\n\n### Examples\n\n1. List all users in the organization:\n\n```bash\nopenai-orgs users list\n```\n\n2. Create a new project:\n\n```bash\nopenai-orgs projects create --name \"My New Project\"\n```\n\n3. List project API keys with JSON output:\n\n```bash\nopenai-orgs project-api-keys list --project-id \u003cproject_id\u003e --output json\n```\n\n4. Create an invite:\n\n```bash\nopenai-orgs invites create --email user@example.com --role member\n```\n\n5. Manage certificates for mutual TLS:\n\n```bash\nopenai-orgs certificates list\nopenai-orgs certificates create --cert-file ./cert.pem\n```\n\n6. View audit logs:\n\n```bash\nopenai-orgs audit-logs list --limit 10\n```\n\n## MCP Server\n\nThe project includes a Model Context Protocol (MCP) server that provides AI assistants with tools and resources for managing OpenAI organizations.\n\n### Running the MCP Server\n\n```bash\n# Run the MCP server\nmcp\n\n# For development with debugging\ntask mcp:dev\n```\n\n### MCP Features\n\n- **Tools**: Complete set of tools for all OpenAI organization and project management operations\n- **Resources**: Dynamic resource templates and subscription management\n- **Type Safety**: Reflection-based parameter validation\n- **Integration**: Works with Claude Desktop and other MCP-compatible AI assistants\n\n### MCP Configuration\n\nAdd to your MCP client configuration (e.g., Claude Desktop):\n\n```json\n{\n  \"mcpServers\": {\n    \"openai-orgs\": {\n      \"command\": \"mcp\",\n      \"env\": {\n        \"OPENAI_API_KEY\": \"your_api_key_here\"\n      }\n    }\n  }\n}\n```\n\n## Default Settings\n\n- The CLI uses the OpenAI API base URL: `https://api.openai.com/v1`\n- Authentication is handled using the `OPENAI_API_KEY` environment variable\n- List commands typically have optional `--limit` and `--after` flags to control pagination\n- Conservative retry strategy: 20 retries, 5-second wait, max 5-minute backoff\n\n## Error Handling\n\nIf an error occurs during command execution, the CLI will display an error message and exit with a non-zero status code.\n\n## Contributing\n\nContributions to `openai-orgs` are welcome! Please submit issues and pull requests on the GitHub repository.\n\n## License\n\nThis project is licensed under the MIT License - see the LICENSE file for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fklauern%2Fopenai-orgs","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fklauern%2Fopenai-orgs","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fklauern%2Fopenai-orgs/lists"}