https://github.com/helmut-hoffer-von-ankershoffen/starbridge
⭐ Integrates Claude Desktop with Google and Atlassian workspaces
https://github.com/helmut-hoffer-von-ankershoffen/starbridge
anthropic atlassian claude confluence cyclonedx devcontainer docker github-actions google-drive jira logfire mcp nox oe-python-template opentelemetry pydantic pytest renovate ruff uv
Last synced: 3 days ago
JSON representation
⭐ Integrates Claude Desktop with Google and Atlassian workspaces
- Host: GitHub
- URL: https://github.com/helmut-hoffer-von-ankershoffen/starbridge
- Owner: helmut-hoffer-von-ankershoffen
- License: mit
- Created: 2024-12-01T11:43:50.000Z (5 months ago)
- Default Branch: main
- Last Pushed: 2025-04-29T23:45:16.000Z (11 days ago)
- Last Synced: 2025-04-30T00:29:07.459Z (11 days ago)
- Topics: anthropic, atlassian, claude, confluence, cyclonedx, devcontainer, docker, github-actions, google-drive, jira, logfire, mcp, nox, oe-python-template, opentelemetry, pydantic, pytest, renovate, ruff, uv
- Language: Python
- Homepage: https://starbridge.readthedocs.io/
- Size: 6.64 MB
- Stars: 8
- Watchers: 0
- Forks: 1
- Open Issues: 18
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Codeowners: CODEOWNERS
- Security: SECURITY.md
Awesome Lists containing this project
README
[//]: # (README.md generated from docs/partials/README_*.md)
# ⭐ Starbridge
[](https://github.com/helmut-hoffer-von-ankershoffen/starbridge/blob/main/LICENSE)
[](https://github.com/helmut-hoffer-von-ankershoffen/starbridge/blob/main/noxfile.py)
[](https://github.com/helmut-hoffer-von-ankershoffen/starbridge/actions/workflows/test-and-report.yml)
[](https://starbridge.readthedocs.io/en/latest/)
[](https://sonarcloud.io/summary/new_code?id=helmut-hoffer-von-ankershoffen_starbridge)
[](https://sonarcloud.io/summary/new_code?id=helmut-hoffer-von-ankershoffen_starbridge)
[](https://sonarcloud.io/summary/new_code?id=helmut-hoffer-von-ankershoffen_starbridge)
[](https://sonarcloud.io/summary/new_code?id=helmut-hoffer-von-ankershoffen_starbridge)
[](https://sonarcloud.io/summary/new_code?id=helmut-hoffer-von-ankershoffen_starbridge)
[](https://github.com/helmut-hoffer-von-ankershoffen/starbridge/security/code-scanning)
[](https://github.com/helmut-hoffer-von-ankershoffen/starbridge/security/dependabot)
[](https://github.com/helmut-hoffer-von-ankershoffen/starbridge/issues?q=is%3Aissue%20state%3Aopen%20Dependency%20Dashboard)
[](https://codecov.io/gh/helmut-hoffer-von-ankershoffen/starbridge)
[](https://github.com/helmut-hoffer-von-ankershoffen/starbridge/blob/main/noxfile.py)
[](https://github.com/helmut-hoffer-von-ankershoffen/starbridge/blob/main/noxfile.py)
[](https://github.com/helmut-hoffer-von-ankershoffen/starbridge/releases)
[](https://github.com/helmut-hoffer-von-ankershoffen/starbridge/commits/main/)
[](https://pypi.python.org/pypi/starbridge)
[](https://pypi.python.org/pypi/starbridge)
[](https://hub.docker.com/r/helmuthva/starbridge/tags)
[](https://hub.docker.com/r/helmuthva/starbridge/)
[](https://github.com/helmut-hoffer-von-ankershoffen/oe-python-template)
[](https://vscode.dev/redirect?url=vscode://ms-vscode-remote.remote-containers/cloneInVolume?url=https://github.com/helmut-hoffer-von-ankershoffen/starbridge)
[](https://github.com/codespaces/new/helmut-hoffer-von-ankershoffen/starbridge)
> [!WARNING]
> This project is currently in pre-alpha phase, i.e. partly functional. Feel
> free to already watch or star the repository to stay updated on its progress.
> [!TIP]
> 📚 [Online documentation](https://starbridge.readthedocs.io/en/latest/) - 📖
> [PDF Manual](https://starbridge.readthedocs.io/_/downloads/en/latest/pdf/)
> [!NOTE]
> 🧠 This project was scaffolded using the template
> [oe-python-template](https://github.com/helmut-hoffer-von-ankershoffen/oe-python-template)
> with [copier](https://copier.readthedocs.io/).
---
Integrates Claude Desktop with the web, Google and Atlassian workspaces.
1. **Make Claude a team member**: Makes Claude an informed member of your
organisation by accessing your organization's key knowledge resources.
2. **Integrate research and knowlege management**: Enables your teams to
contribute, refine, and maintain your organisation's knowledge resources
within Claude - seamlessly integrating research and sharing knowledge.
3. **Improve efficiency**: Automate repetitive workflows such as generating
Confluence pages from Google Docs.
## Example Prompts
- "Create a page about road cycling, focusing on Canyon bikes, in the personal
confluence space of Helmut."
## Setup
If you already have [uv](https://astral.sh/uv) package manager and
[Claude Desktop](https://claude.ai/download) installed on your Mac:
```shell
# Installs starbridge in an isolated Python environment
# Auto-injects configuration into Claude Desktop
uvx starbridge install
```
If you first need to install uv:
```shell
if ! command -v brew &> /dev/null; then # Install Homebrew
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
fi
brew install uv # Install uv via Homebrew
uvx starbridge install # Install starbridge via uv
```
If you want to install starbridge with the imaging extra
```shell
uvx --with "starbridge[imaging]" starbridge install
```
You can as well
[run Starbridge with Docker](https://starbridge.readthedocs.io/en/latest/docker.html).
## MCP Server
Starbridge implements the
[MCP Server](https://modelcontextprotocol.io/docs/concepts/architecture)
interface, with Claude acting as an MCP client.
### Resources
[TODO: Document resources exposed to Claude Desktop]
### Prompts
[TODO: Document prompts exposed to Claude Desktop]
### Tools
[TODO: Document tools exposed to Claude Desktop]
## CLI
[TODO: Document CLI commands]
## Operational Excellence
This project is designed with operational excellence in mind, using modern
Python tooling and practices. It includes:
1. Complete reference documentation
[of the CLI](https://starbridge.readthedocs.io/en/latest/cli_reference.html)
and
[of the library](https://starbridge.readthedocs.io/en/latest/lib_reference.html)
on Read the Docs
2. [Transparent test coverage](https://app.codecov.io/gh/helmut-hoffer-von-ankershoffen/starbridge)
including unit and E2E tests (reported on Codecov)
3. Matrix tested with
[multiple python versions](https://github.com/helmut-hoffer-von-ankershoffen/starbridge/blob/main/noxfile.py)
to ensure compatibility (powered by [Nox](https://nox.thea.codes/en/stable/))
4. Compliant with modern linting and formatting standards (powered by
[Ruff](https://github.com/astral-sh/ruff))
5. Up-to-date dependencies (monitored by
[Renovate](https://github.com/renovatebot/renovate) and
[Dependabot](https://github.com/helmut-hoffer-von-ankershoffen/starbridge/security/dependabot))
6. [A-grade code quality](https://sonarcloud.io/summary/new_code?id=helmut-hoffer-von-ankershoffen_starbridge)
in security, maintainability, and reliability with low technical debt and
codesmell (verified by SonarQube)
7. Additional code security checks using
[CodeQL](https://github.com/helmut-hoffer-von-ankershoffen/starbridge/security/code-scanning)
8. [Security Policy](SECURITY.md)
9. [License](LICENSE) compliant with the Open Source Initiative (OSI)
10. 1-liner for installation and execution of command line interface (CLI) via
[uv(x)](https://github.com/astral-sh/uv) or
[Docker](https://hub.docker.com/r/helmuthva/starbridge/tags)
11. Setup for developing inside a
[devcontainer](https://code.visualstudio.com/docs/devcontainers/containers)
included (supports VSCode and GitHub Codespaces)
## Further Reading
- Inspect our
[security policy](https://starbridge.readthedocs.io/en/latest/security.html)
with detailed documentation of checks, tools and principles.
- Check out the
[CLI Reference](https://starbridge.readthedocs.io/en/latest/cli_reference.html)
with detailed documentation of all CLI commands and options.
- Check out the
[Library Reference](https://starbridge.readthedocs.io/en/latest/lib_reference.html)
with detailed documentation of public classes and functions.
- Our
[release notes](https://starbridge.readthedocs.io/en/latest/release-notes.html)
provide a complete log of recent improvements and changes.
- In case you want to help us improve ⭐ Starbridge: The
[contribution guidelines](https://starbridge.readthedocs.io/en/latest/contributing.html)
explain how to setup your development environment and create pull requests.
- We gratefully acknowledge the
[open source projects](https://starbridge.readthedocs.io/en/latest/attributions.html)
that this project builds upon. Thank you to all these wonderful contributors!
## Star History
